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ORDER  DWOPSIM  ON  DISK 


The  DWOPSIM  model  building  framework  and  the  sample  model  TIME  are  available 
on  a  3.5",  1 .44  MB  diskette.  Please  note  that  DWOPSIM  requires  an  IBM  or  compat¬ 
ible  computer,  DOS  3.3  or  higher,  SuperCalc  5  spreadsheet  software,  2  MB  of  avail¬ 
able  RAM,  and  at  least  3  MB  of  hard  disk  space.  Also,  the  TSView  database  used  by 
DWOPSIM  (see  Appendix  1)  is  available  on  two  3.5"  diskettes.  This  product  requires 
330  KB  of  RAM  and  at  least  650  KB  of  hard  disk  storage. 

To  order,  just  dial  1-800-999-6779.  Toll  free  in  the  United  States 
and  Canada.  Other  areas,  please  call  1-703-834-0125. 

Ask  for  the  DWOPSIM  database,  order  #93001 ,  $25,  and  the  PS&D  View  database, 
order  #93002A,  $35.  Add  25  percent  for  shipping  to  foreign  addresses  (including  Can¬ 
ada).  Charge  your  purchase  to  your  VISA  or  MasterCard.  Or  send  a  check  (made 
payable  to  ERS-NASS)  to: 


ERS-NASS 
341  Victory  Drive 
Herndon,  VA  22070 

For  further  information  on  this  database,  write  to  Vernon  Roningen,  Room  735,  1301 
New  York  Avenue,  NW.,  Washington,  DC  20005-4788  or  call  (202)  219-0682. 
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Framework.  By  Vernon  Oley  Roningen,  Agriculture  and  Trade  Analysis  Division, 
Economic  Research  Service,  U.S.  Department  of  Agriculture,  Staff  Report  No. 
AGES  9226. 


Abstract 

This  report  documents  the  dynamic  world  policy  simulation  (DWOPSIM)  model 
building  framework.  DWOPSIM,  a  set  of  DOS  batch  computer  programs  and 
spreadsheet  templates,  allows  users  to  assemble  globally  consistent  data  sets 
into  time  series  models.  Such  models  are  used  for  policy  analysis,  short-term 
forecasting,  and  long-term  projections.  Users  choose  equations  and  code  the 
structure  along  with  model  parameters  into  spreadsheet  templates.  DWOPSIM 
provides  computer  programs  for  the  generation  of  model  equations ,  the 
calculation  of  constant  terms,  the  assembly  of  spreadsheet  components  into  a 
linked  global  model,  and  the  generation  of  simulation  output. 

Keywords:  Agricultural  trade,  DWOPSIM,  forecasting  model,  projections  model, 

trade,  trade  model,  world  trade  model. 
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Documentation  of  the  Dynamic  World  Policy 
Simulation  (DWOPSIM)  Model  Building  Framework 

Vernon  Oley  Roningen 


Introduction 

This  report  documents  the  dynamic  world  policy  simulation  (DWOPSIM)  model 
building  framework.  DWOPSIM  allows  the  user  to  construct  global  multi- 
product,  multicountry  time  series  models  and  solve  them  in  spreadsheets.  The 
framework  is  a  set  of  DOS  batch  computer  programs  and  spreadsheet  templates 
that  help  a  user  with  various  tasks  needed  to  build  time  series  models, 
including  the  generation  of  model  equations  from  a  model  specification  coding 
scheme,  the  calculation  of  constants/intercepts  for  equations  for  a  base 
period,  the  assembly  of  product  and  country  spreadsheets  into  a  linked  world 
model,  and  the  generation  of  simulation  output.  The  framework  also  includes 
routines  that  construct  globally  consistent  supply  and  utilization  tables  from 
a  TSView  database.  The  use  of  the  DWOPSIM  framework  is  illustrated  with  a 
small  two-product,  three-region  world  model  that  forecasts/projects  variable 
values  from  the  present  to  the  year  2020. 

The  report  begins  with  an  overview  of  the  DWOPSIM  model  building  framework  and 
a  flowchart  summarizing  the  model  building  process.  This  is  followed  by  a 
discussion  of  data  preparation,  including  a  description  of  DWOPSIM  programs. 
Next,  the  process  of  specifying  model  equations  and  entering  their  parameters 
into  DWOPSIM  equation  spreadsheets  is  explained.  The  entry  of  exogenous  data 
into  product,  country,  and  world  spreadsheets  is  then  discussed.  Procedures 
for  product  model  initialization  and  world  model  assembly  are  illustrated. 
Finally,  model  simulation  and  output  generation  are  discussed. 

The  DWOPSIM  framework  is  illustrated  with  a  small  global  time  series  model 
named  TIME.  Appendices  describe  the  TSView  database  used  for  the 
demonstration  model  and  provide  sample  documentation  of  the  demonstration 
model  TIME.  DWOPSIM  computer  programs  are  also  documented  in  an  appendix. 


Overview  of  the  DWOPSIM  Model  Building  Framework 

While  static  global  models  are  useful  and  practical  for  global  policy  analysis 
(1,6)  and  projections  (.5),  there  are  also  good  reasons  to  use  models  that  show 
the  time  path  of  variables  under  various  simulation  scenarios.1  For  example, 
an  analyst  might  want  to  do  short-term  forecasting  or  long-term  projections. 
Dynamic  considerations  represented  by  lagged  variables  might  be  considered 
important  in  certain  modeling  situations.  From  a  technical  viewpoint,  it  is 
more  difficult  to  create  well-behaved  dynamic  time  series  models  than  static 
models.  Data  requirements  for  time  series  models  are  greater,  and  dynamic 
properties  may  cause  solution  problems  for  such  models  (4) .  Just  as 
spreadsheets  have  proved  to  be  a  practical  vehicle  for  the  construction  of 
global  static  models,  the  DWOPSIM  spreadsheet  modeling  framework  can  provide 
similar  advantages  for  dynamic  time  series -based  models. 


Underscored  numbers  in  parentheses  refer  to  items  cited  in  the  References 
section . 
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Experience  with  the  static  world  policy  simulation  (SWOPSIM)  modeling 
framework  (6)  led  to  the  DWOPSIM  framework,  which  allows  for  dynamic  time 
series  modeling  but  retains  the  spreadsheet  as  the  modeling  vehicle.  In  the 
static  SWOPSIM  modeling  framework,  a  premium  was  put  on  a  standard  simple 
economic  structure  that  allowed  much  of  the  routine  model  building  and 
assembly  work  to  be  done  by  computer  programs  operating  on  spreadsheets. 
Dynamic  modeling  requires  many  more  choices  to  be  made  regarding  model 
specification.  Therefore,  DWOPSIM  was  designed  to  allow  the  user  full 
discretion  in  model  specification  and  parameterization,  while  retaining  the 
convenience  and  user  accessibility  of  spreadsheets.2  In  addition,  given  the 
existence  of  consistent  global  data  sets  available  with  USDA's  TSView  database 
system  (2) ,  the  DWOPSIM  framework  includes  an  option  that  allows  the  user  to 
construct  a  globally  consistent  supply  and  utilization  data  set  for  products 
to  be  modeled.  DWOPSIM  uses  the  SuperCalc  5  spreadsheet.3 

DWOPSIM  model  components  reside  in  spreadsheets.  Organization  of  the  model 
structure  in  spreadsheets  is  entirely  up  to  the  user.  Because  the 
demonstration  model  TIME  is  based  on  a  TSView  product  data  set  that  is 
organized  by  product,  each  product  in  TIME  resides  in  a  separate  spreadsheet 
for  each  country.  Each  country  in  TIME  was  given  a  separate  spreadsheet  for 
country  specific  data.  Finally,  a  world  model  requires  a  spreadsheet 
containing  world  reference  prices  and  any  other  global  data  needed.  Figure  1 
shows  the  DWOPSIM  data  structure  selected  for  the  demonstration  model  TIME 
used  in  this  report.  Following  the  country  and  product  nomenclature  from  the 
TSView  data  source  (2) ,  the  model  TIME  divides  the  world  into  three 
countries/regions,  the  United  States  (US),  the  European  Community-12  (EC),  and 
the  rest  of  the  world  (RW) .  Two  products  are  modeled,  beef  and  veal  (BF)  and 
corn  (CN) .  The  model  TIME  is  organized  into  six  product/country  spreadsheets, 
three  country/region  spreadsheets,  and  one  world  reference  price  spreadsheet. 
Typical  linkages 
between 

spreadsheets  via 
model  equations  are 
shown  with  lines 
and  arrows . 


The  construction  of 
a  DWOPSIM  model 
consists  of  the 
assembly  of  data 
and  the  coding  of 
the  equation 
structure  and 
parameters  in  the 


Figure  1- -Organization  structure  of  spreadsheets  for  the 
demonstration  model  TIME 


Product  &  country/region  spreadsheets 
containing  historical  data  and  equations 


Country/region  spreadsheets  with 
historical  and/or  exogenous  data 


USBF 

ECBF 

RWBF 

USCN 

ECCN 

_ 1 

RWCN 

1 

L 

US 


EC 


DU 

WD 


World  reference  price  spreadsheet 


2This  is  different  from  the  SWOPSIM  modeling  strategy  where  a  simple 
standard  specification  was  used  and  built  into  the  SWOPSIM  framework.  In 
contrast,  DWOPSIM  models  require  the  user  to  provide  all  of  the  structure, 
specification,  and  parameters  for  model  equations.  The  user  can  choose  the 
spreadsheet  structure  for  the  model.  The  demonstration  model  TIME  is 
organized  with  one  spreadsheet  per  product;  however,  alternative 
organizational  schemes  are  possible. 

3SuperCalc  is  a  registered  trademark  of  Computer  Associates  International 
Inc.,  1240  McKay  Drive,  San  Jose,  CA  95131,  408-432-1727. 
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appropriate  spreadsheets,  the  writing  of  model  equations  in  spreadsheets  from 
the  specification  codes,  the  initialization  of  equations  to  base  period  data 
by  the  calculation  of  constant  terms,  and  the  creation  of  a  global  model  by 
linking  the  spreadsheets  in  memory/  Much  of  this  construction  is  carried 
out  by  DWOPSIM  programs.  The  updating  of  data  or  parameters  simply  requires  a 
repetition  of  DWOPSIM  operations  after  manual  changes  have  been  made  in 
spreadsheets.  The  model -building  flowchart  on  the  following  page  summarizes 
the  operations  required  to  build  and  maintain/update  a  DWOPSIM  model. 

The  first  task  in  creating  a  DWOPSIM  model  is  to  assemble  globally  consistent 
data  sets  for  the  products  and  countries  to  be  modeled  in  a  chosen  spreadsheet 
layout.  This  task  can  be  done  manually.  But,  if  agricultural  products  from 
U.S.  Department  of  Agriculture's  (USDA) ,  Foreign  Agricultural  Service  (FAS) 
data  are  being  modeled,  the  framework  provides  a  set  of  programs  that  allow 
the  user  to  easily  prepare  a  set  of  quantity  supply  and  utilization  data  from 
a  SWOPSIM  version  of  USDA's  TSView  product  data  (7).  Given  that  the  user 
selects  a  product  from  the  TSView  data  set,  programs  automatically  generate  a 
product  spreadsheet  for  each  country  in  a  model.* * * * 5  This  step  is  accomplished 
by  the  program  DWOPTIME  shown  in  a  box  at  the  top  of  the  flowchart.  As  with 
SWOPSIM  models,  each  DWOPSIM  model  requires  a  rest-of- the-world  region  to 
close  world  markets  for  the  selected  product.  DWOPSIM  programs  adjust  data 
for  the  closure  region  (RW)  to  maintain  world  identities  of  zero  net  trade  and 
balanced  world  supply  and  demand  in  each  historical  period. 

The  DWOPSIM  model  builder  must  specify  and  parameterize  model  equations.  This 
is  done  by  coding  in  the  equation  structure  and  parameters  into  a  specific 
equation  spreadsheet.  The  user  is  free  to  specify  any  equation  structure  and 
must  rely  on  external  analysis  for  equation  parameters.  In  the  demonstration 
model,  TIME  shown  in  the  flowchart,  spreadsheets  containing  equation  codes  and 
equations  are  organized  by  product  with  one  country  per  product  sheet. 

Once  spreadsheets  have  been  created  for  all  products  and  countries  and  the 
associated  equation  spreadsheets  have  been  coded,  the  user  must  add  exogenous 
data  required  by  the  model  specification.  In  the  example  TIME,  product- 
specific  data  goes  into  the  product  (such  as  USBF)  spreadsheet,  while  country  - 
specific  data  goes  into  the  country  spreadsheet  (such  as  US) .  In  addition, 
world  reference  price  data  must  be  put  into  world  reference  price  spreadsheet 
(WD) .  Next,  the  program  DWOPINIT  is  used  to  initialize  the  model 
spreadsheets.  This  means  that  information  in  the  equation  specification 
spreadsheet  on  equation  form  and  parameters  is  used  to  write  equations  and 
initialize  each  equation  to  base  period  data.  When  the  process  has  been 
completed  for  each  spreadsheet,  the  user  is  ready  to  assemble  a  world  model. 


^Linkages  between  spreadsheets  occur  via  SuperCalc  5's  capacity  to 

reference  other  spreadsheets  in  spreadsheet  equations.  When  linked 

spreadsheets  are  loaded  into  memory,  these  linkages  operate  as  a  set  of 

simultaneous  equations  reaching  across  spreadsheets. 

5In  the  example  of  the  model  TIME  in  figure  1,  DWOPSIM  programs  would 
create  the  spreadsheets  USBF,  ECBF,  and  RWBF  where  world  net  trade  for  BF 
would  sum  to  zero.  A  second  operation  would  create  similar  data  spreadsheets 
containing  supply  and  utilization  data  for  CN.  This  is  accomplished  by  the 
program  DWOPTIME,  which  has  been  created  and  customized  for  this  operation  for 
the  model  TIME. 
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DWOPSIM  Model  Building  Flowchart 

(the  model  TIME  with  a  product-based  spreadsheet  structure  used  as  an  example) 

Step  1- -ASSEMBLE  GLOBAL  DATA  SET  (illustrated  by  the  model  TIME,  which  uses  a  product  spreadsheet  organization) 


DWOPTIME  program 

< — Fetch  product  data  from  TSView  database . < 

DWOPGSUP 

(program  customized 

for  the  DWOPSIM 

<--Globally  balance  data  (in  RW  region)  for  a  product-< 

DWOPRW 

model  TIME.) 

ft"  - L 

T 


Step  2* 


Step  3- 


Product  spreadsheets 
for  countries/ regions 
containing  historical 
time  series  data  from 
a  TSView  database. 


*  Enter/update  * 
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******************* 
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******************* 


******★*★★★★******★★**★★* 

*  Enter/update  exogenous* 
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*  reference  prices.  * 
************************* 
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Product  equation  spread¬ 
sheets  for  countries/ regions 
in  world  model  with  equation 
specification  and  parameters 
for  each  variable. 
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titles) 


************************** 
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************************** 

INITIALIZE  EQUATIONS  IN  1  SPREADSHEETS . 

count  r i es/reg i ons . 

for  a  DWOPSIM  model. 

-ASSEMBLE  WORLD  LINKED  MODEL  IN  MEMORY  FOR  SIMULATION  . 


Product  spreadsheets  for  countries/regions 
containing  historic  time  series  data  from 
a  TSView  database  and  equations  as  specified 
in  the  product  equation  spreadsheets,  which 
are  initialized  to  base  period  data. 


T IMESOLV 
program 
(customi zed 
for  the 
DWOPSIM 
model 
TIME). 
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DWOPSOLV  program 


DWOPCVAR  program  compares  up  to 
four  alternative  world  model 
solutions  and  baseline  values 
for  a  selected  model  variable. 


TIMEAGAN  program 
for  more  solutions. 


DWOPWDS 

program 


Other  * 
ut  i l i ty 
programs 


DWOPCSOL  program  compares  values 
for  up  to  four  variables  from  a 
world  model  solution  with 
historic/baseline  data. 


Linked  spreadsheets  in  memory  for 
all  products  and  countries/ regions 
in  a  world  model.  F9  solves  the 
model  if  trade  is  not  balanced  for 
each  product.  Solution  output  can 
be  saved  with  the  ALT-S  macro 
command. 


Key  to  boxes: 


*********************************** 
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*********************************** 
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DWOPEOUT,  DWOPBOUT,  and  DWOPSOUT  print  the  contents 
of  an  equation,  history/baseline  data,  and  a 
solution  spreadsheet,  respectively.  DWOPTRND 
calculates  a  trend  line  regression  for  a 
DWOPSIM  variable. 


Spreadsheets  linked  in  memory 
to  make  up  a  world  model. 
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The  assembly  of  a  world  model  for  simulation  is  done  by  the  DWOPSIM  program 
DWOPSOLV.  The  equation  portion  of  product  and  country  spreadsheets  is  loaded 
into  computer  memory  along  with  a  world  price  equilibrium  mechanism.  When  a 
year's  (or  years')  data  are  not  in  balance  due  to  policy  or  other  economic 
shocks  entered  into  the  model,  the  set  of  spreadsheets  with  cross-product  and 
cross-country  linkages  can  be  solved  in  memory  to  achieve  zero  world  net  trade 
in  each  simulation  period.  The  solution  values  of  the  spreadsheets  can  be 
saved  and  compared  with  historical/baseline  data. 

In  addition  to  the  DWOPSIM  routines  mentioned  above,  various  utility  programs 
are  available  to  the  user  for  various  tasks ,  such  as  printing  data  and 
equations.  DWOPSIM  programs  are  DOS  batch  programs  that  write  and  execute 
macros  that  operate  on  spreadsheet  templates.  The  casual  DWOPSIM  user  must 
have  some  knowledge  of  DOS  and  familiarity  with  SuperCalc  5  spreadsheet 
commands.  However,  the  mechanics  behind  DWOPSIM  programs  are  fairly  simple. 
The  ambitious  user  who  knows  DOS  batch  programming  and  SuperCalc  5  macro - 
commands  can  easily  create  DWOPSIM- like  routines  for  his  own  purposes. 

Because  dynamic  models  are  more  complex  and  can  be  specified  in  many  ways, 
DWOPSIM  leaves  specification  questions  largely  up  to  the  model  builder.  The 
demonstration  model  (TIME)  used  to  illustrated  the  DWOPSIM  framework  builds 
upon  the  simple  specification  and  parameters  for  BF  and  CN  found  in  the  US, 

EC,  and  RW  model  components  of  the  SWOPSIM  model  DEMO  described  in  SWOPSIM 
documentation  (6) .  The  product-based  organization  of  TIME  follows  from  the 
product  organization  of  TSView  supply  and  utilization  data,  but  other  model 
organization  schemes  are  possible.  Dynamic  models  typically  require  more  data 
and  parameters  than  static  ones,  especially  if  lag  structures  are  involved. 
Therefore,  questions  of  model  size  and  computational  efficiency  become 
relatively  more  important  for  dynamic  models  than  for  static  models. 


Computer  Requirements 

The  technical  computer  limit  for  the  size  of  DWOPSIM  models  is  the  expanded 
memory  available  for  holding  SuperCalc  5  spreadsheet (s) .  In  addition, 
SuperCalc  5  has  a  limit  of  255  linked  spreadsheets  in  memory  at  one  time.6 
This  means  that  a  microcomputer  with  a  large  memory  should  be  able  to  handle  a 
large  model.  However,  the  user  is  always  cautioned  by  the  rule,  "big  models 
can  be  big  trouble."  Large  models  are  typically  slower  to  solve  and  more 
difficult  to  interpret;  thus,  there  may  be  "practical"  limits  to  model  size 
that  might  be  reached  even  if  technical  computer  limitations  are  not  breached. 
SuperCalc  5  spreadsheet  defaults  must  be  set  correctly.  This  can  be  done 
automatically  by  typing  in  the  program  name  DWOPSIM  and  by  following  the 
directions  on  the  screen. 


6The  model  TIME  used  to  illustrate  DWOPSIM  in  this  report  consists  of  two 
products  (BF  and  CN)  and  three  regions  (US,  EC,  and  RW) .  This  gives  2x3=6 
product/country  spreadsheets  and  one  world  reference  price/solution  mechanism 
spreadsheet,  for  a  total  of  seven  spreadsheets  that  will  have  to  be  kept 
simultaneously  in  memory  in  a  linked  mode.  Three  country/region  spreadsheets 
contain  only  exogenous  data  so  they  do  not  have  to  be  kept  in  memory.  If 
another  organizational  scheme  was  used,  such  as  a  country  one  (where  all 
product  data  for  a  country  is  on  one  spreadsheet) ,  only  four  spreadsheets 
would  have  to  be  kept  in  memory. 
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The  current  version  of  DWOPSIM  does  have  practical  limits  built  into  it.  For 
example,  the  equation-writing  program  (a  spreadsheet  itself)  allows  only  28 
variables  per  model  spreadsheet,  variable  lags  of  up  to  9  periods,  and  a  data 
(annual)  range  from  1960  to  2020.  These  "design"  limits  could  be  exceeded 
with  bothersome  changes  in  existing  DWOPSIM  programs  and  accompanying 
spreadsheet  templates.  These  limits  are  partially  based  on  practical  matters, 
such  as  a  desire  to  limit  model  printouts  to  two  pages.  Default  printouts  of 
DWOPSIM  output  are  dependent  upon  the  capability  of  laser  printers  to  produce 
small  print  so  that  a  lot  of  information  can  fit  on  a  page.  However,  DWOPSIM 
programs  also  have  the  option  to  print  to  a  disk  file  so  that  other  programs 
can  "fit"  the  data  to  paper.7 


The  programs  which  take  data  from  the  TSView  system  assume  that  TSView  files 
are  on  the  E:  disk.  However,  the  controlling  batch  software  can  be  changed 
for  another  disk  configuration.  TSView  data  are  organized  as  described  in 
appendix  1.  TSView  data  sets  with  different  organization  and  product 
structures  could  also  be  used,  provided  that  some  programming  was  done  to 
develop  suitable  two- letter  country  and  product  codes  (which  are  required  for 
DWOPSIM  equation-writing  programs) . 


Most  DWOPSIM  programs  are  applicable  to  all  models,  but  a  few  key  ones  must  be 
constructed  for  EACH  specific  model  (for  example,  the  programs  with  TIME 
included  in  their  name  in  the  model-building  flowchart) .  When  the  user 
creates  new  models,  one  way  of  supplying  the  "model"  specific  programs  and 
spreadsheet  templates  is  to  copy  them  from  the  model  TIME  to  a  new  model  name 
and  edit  them  manually.  The  DWOPSIM  program  TIMEREPL  (screen  1)  gets  the  user 
started  in  this 


direction  by 
copying  the 
necessary  files  to 
the  D:  drive  and 
renaming  them  with 
the  new  model  name. 
Model  configuration 
and  nomenclature  in 
this  report  (that 
is ,  country  and 
product  codes) 
follow  those  used 
in  the  TSView 
database  for 
SWOPSIM  models. 
DWOPSIM  batch 
programs  (with  the 
first  four  letters 
of  their  name  being 
DWOP)  are  housed  in 
the  C:\BATCH 
subdirectory. 


Screen  1--The  program  TIMEREPL 


TIME  Replication  Program  for  a  New  DWOPSIM  Model 


TIMEREPL  Program  to  REPLicate  model  specific  TIME  model  programs  and 

spreadsheet  templates  files  for  use  with  a  new  DWOPSIM 
model,  NAME.  A  two  product,  three  region  demonstration 
model,  TIME,  comes  with  the  DWOPSIM  model  building  system. 
NAME*. BAT  and  NAME*. CAL  files  will  be  left  on  D:  and  must 
be  edited  manually  to  accommodate  the  product  and  country 
coverage  of  the  new  model  NAME.  *.CAL  and  *.SUB  files 
must  be  copied  to  the  C:\NAME  subdirectory  for  safekeeping. 
*.BAT  files  must  be  copied  to  the  C:\BATCH  subdirectory. 

REQUIREMENTS  The  TIME  model  must  exist  on  the  C:\TIME  subdirectory  and 
all  of  the  appropriate  batch  files  must  exist  on  the 
C:\BATCH  subdirectory. 

OUTPUT  (D:)  The  output  files  will  reside  on  the  D:  subdirectory. 

These  include  DWOPNAME.BAT,  NAMERW . SUB ,  NAMESOLV.BAT,  and 
WDS.CAL  (which  must  be  customized  for  products  in  NAME). 


COMMAND  TIMEREPL  NAME 


7Small  print  is  obtained  on  laser  printers  in  DWOPSIM  output  programs  by 
invoking  Laser  Control  software.  Laser  Control  is  a  registered  trademark  of 
Insight  Development  Corporation.  Printouts  of  ASCII  files  on  disk  can  be 
obtained  in  various  sizes  and  configurations  of  print  by  the  SIDEWAYS  program, 
which  comes  with  the  SuperCalc  5  spreadsheet  package . 
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Batch  programs  specific  to  the  demonstration  model  TIME  (first  four  letters  of 
their  name  being  TIME)  are  also  housed  in  the  C:\BATCH  subdirectory.  DWOPSIM 
programs  are  kept  in  the  C:\DWOPSIM  subdirectory,  while  spreadsheets  and  other 
files  for  the  model  TIME  are  kept  in  the  C:\TIME  subdirectory.  In  contrast  to 
SWOPSIM,  DWOPSIM  file  names  do  not  contain  the  model  name.  As  was  the  case 
with  SWOPSIM,  DWOPSIM  programs  leave  their  results  on  the  D:  drive  where  they 
must  be  manually  copied  to  the  model  subdirectory  for  permanent  safekeeping. 

DWOPSIM  programs  all  have  explanatory  screens  (such  as  screen  1) ,  which  can  be 
invoked  by  typing  the  program  name  (use  capital  letters)  without  the 
parameters  required  by  the  program.  Error  traps  have  been  built  into  the 
programs  to  alert  the  user  if  file  preparation  steps  have  been  omitted. 


Assembly  of  Globally  Consistent  Quantity  Data  in  Model  Spreadsheets 

The  first  step  in  creating  a  global  trade  model  is  the  assembly  of  a 
consistent  set  of  quantity  data,  including  globally  balanced  trade  data.  This 
can  be  done  manually  by  carefully  entering  data  into  spreadsheets.  The  number 
and  organization  of  spreadsheet  components  of  a  model  is  up  to  the  user.  It 
should  be  kept  in  mind  that  a  world  market-clearing  mechanism  will  have  to  be 
designed  based  on  some  principle.  The  model  TIME  does  this  by  clearing  world 
net  trade  for  each  product  with  a  mechanism  that  changes  world  prices  until 
net  world  trade  equals  zero. 


The  SWOPSIM  Screen  2 --The  program  DWOPTIME 

modeling  framework 
has  routines  that 


reformulate  USDA's 
global  FAS  supply 
and  utilization 
data  into  a  TSView 
143-country/region 
database.8  This 
database  serves  as 
the  repository  for 
product  supply  and 
utilization 
quantity  data  used 
to  generate  the 
product 

spreadsheet  data 
for  each  country 
in  the  model  TIME. 


DWOPSIM  Program  to  create  TSView-based  data  for  model  TIME 


DWOPTIME  Program  to  make  a  complete  set  of  balanced  supply  and 

demand  spreadsheets  for  a  selected  PRoduct  from  a  TSView 
data  set  for  each  CountrY  in  the  model  TIME,  including  a 
globally  balanced  RW  (Rest-of-World  bal.  with  DWOPBLRW). 

REQUIREMENTS  A  E:\TS  subdirectory  must  contain  the  PRoduct  TSVIEW  files. 

A  subtraction  control  file  for  TSView  software  must  be  on 
the  model  NAME  subdirectory  with  the  name  NAMERW.SUB. 

An  example  of  such  a  file  for  a  three  region  world  (US,  EC, 
and  RW)  where  RW  =  WD  -  US  -  EC  might  be: 


TEMP . TS 
TEMP . TS 
1 

RW  13  5 

RW  =  WD-US-EC  (Codes  for  TSView  #s) 


OUTPUT  (D:)  CYPR  spreadsheets  for  each  CountrY  in  TIME  plus  the 
globally  balanced  RWPR  spreadsheet. 


The  program  command  dwoptime  pr 

DWOPTIME  (screen 

2)  is  created  for 

the  model  TIME  to 

automatically 

carry  out  the  data  retrieval  operation.  DWOPTIME  not  only  gets  data  for  the 
US  and  the  EC  and  calculates  data  for  RW  (-  World  -  US  -  EC),  but  it  also 
performs  an  exercise  on  RW  data  to  make  sure  the  total  world  trade  for  all 


8More  information  about  the  TSView  database  (7.)  used  for  DWOPSIM  is  found 
in  appendix  1,  which  lists  the  country  and  product  codes. 
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three  regions  sums  to  zero  and  that  world  supply  balances  world  demand  in  each 
historical  year.9  The  global-balancing  criteria  are  found  in  the  spreadsheet 
DWOPBLRW . CAL ,  which  is  used  by  DWOPTIME.  Figure  2  shows  what  part  of  the  USBF 
spreadsheet  looks  like  after  DWOPTIME  is  run.  The  spreadsheet  output  of 
DWOPTIME  is  formatted  by  the  DWOPTEMP.CAL  spreadsheet.  This  includes  column 
titles  (but  not  units)  copied  from  the  TSView  database.  A  DOS  batch  program 
equivalent  to  DWOPTIME  must  be  assembled  for  each  new  model.  A  convenient  way 
of  doing  this  is  to 
invoke  the  program 
TIMEREPL  (screen  1) 
with  a  new  model  name 
(with  four  letters  or 
digits)  and  edit  the 
new  file  in  places 
that  are  bounded  by 
"rem  ***. . "  lines . 

For  example,  if  a 
different  model  has 
five  countries/regions 
instead  of  the  three 
in  TIME,  extra  lines 
will  have  to  be  added 
for  the  new  countries. 

DWOPTIME  uses  an  ASCII 
file  TIMERW. SUB ,  which 
also  must  be  created 
for  each  new  model. 

TIMERW. SUB  is  used  by 
one  of  the  TSView 
utility  programs  when 
RW  data  are  derived  by 
subtracting  US  and  EC 
data  from  world  (WD) 
data  in  the  TSView 
database.  This  file, 
which  defines  the 
residual  region  RW  for 
a  model,  must  be 
properly  created  for 
each  new  model  and 
saved  on  the  model 
subdirectory.  The 
full  explanation  of 
the  format  of 
TIMERW. SUB  (fig.  3)  is 
found  in  TSView 
documentation  ( 2 ) . 

Basically,  this  file 
causes  TSView  to 
subtract  data  for  the 


Figure  3 --File  TIMERW. SUB  for  model  TIME 


TEMP.TS  <-  Source  file  name  (NEWRW.SUB) 

TEMP.TS  <-  Destination  file  name  (can  be  same  as  source) 

1  <--  Number  of  new  blocks  to  create 

RW  13  5 

RW  =  WD-US-EC  (Country  codes  for  TS  numbers  above) 


Figure  2- -Part  of  USBF  spreadsheet  created  by  DWOPTIME 
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9TSView  software  contains  a  set  of  utilities  that  allows  the  user  to 
manipulate  TSView  data  and  put  it  into  spreadsheets.  DWOPTIME  and  related 
programs  make  use  of  these  TSView  utilities. 
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US  (TSView  country  #3)  and  the  EC  (country  #5)  from  world  data  (TSView  region 
#1) .  After  DWOPTIME  is  run  for  a  selected  product,  separate  spreadsheets  are 
left  on  drive  D:  for  the  product  for  each  country  designated  in  the  DWOPTIME 
program.  For  example,  when  the  command  "DWOPTIME  BF"  is  run  for  the  product 
"beef  and  veal,"  the  files  USBF.CAL,  ECBF.CAL  and  RWBF.CAL  will  be  found  on 
the  D:  drive.  These  files  can  then  be  edited  and  product- specific  data  can  be 
added.  The  files  must  be  manually  copied  to  the  TIME  subdirectory  for 
safekeeping  and  further  use  by  the  DWOPSIM  modeling  framework. 

In  addition  to  product/country  files  (such  as  USBF) ,  country  files  (such  as 
US)  and  a  world  reference  price  file  (WD)  with  exogenous  data  also  are 
required  for  the  model  TIME.  Figures  4  and  5  show  parts  of  these  two  files. 
Note  in  figure  5  that  the  current  DWOPSIM  spreadsheet  format  allows  data  to  be 
simulated  or  projected  up  to  the  year  2020  (not  all  data  are  shown).  Projects 
needing  projections  beyond  this  year  would  require  an  extensive  reformatting 
of  DWOPSIM  template  spreadsheets  and  some  changes  in  DWOPSIM  programs. 


Figure  4- -Spreadsheet 
US . CAL  for  the  model  TIME 
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Figure  5- -Spreadsheet  WD.CAL 
for  the  model  TIME 
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Once  the  basic  data  for  the  spreadsheets  have  been  prepared,  the  next  step  is 
to  define  the  model  structure  by  specifying  equations  and  adding  equation 
parameters.  This  is  done  in  an  equation  specification  spreadsheet,  which 
accompanies  every  model  spreadsheet  containing  variables  to  be  modeled.  The 
center  of  any  DWOPSIM  model  becomes  pairs  of  spreadsheets.  In  the  case  of  the 
demonstration  model  TIME,  there  is  a  pair  of  spreadsheets  for  each  product  for 
each  country.  One  spreadsheet- -which  is  called  the  model  spreadsheet- - 
contains  data  and  equations  that  forecast  or  project  the  data  into  the  future. 
The  other  spreadsheet- -which  we  will  call  the  equation  specification,  or  just 
equation  spreadsheet- -contains  the  coding  of  equations  and  equation  parameters 
for  the  model  spreadsheet. 


Equation  Parameters  and  Specification  in  Equation  Spreadsheets 

In  a  model  spreadsheet,  values  of  variables  for  years  beyond  the  base  year 
will  require  either  equations  calculating  the  variable  or  exogenous  data 
values.  Each  DWOPSIM  model  spreadsheet  holding  equations  MUST  have  an 
accompanying  equation  (specification)  spreadsheet.  This  key  equation 
information  is  used  by  DWOPSIM  programs  to  write  the  equations  in  the 
appropriate  place  in  the  model  spreadsheet.  For  example,  equations  in  the 
model  spreadsheet  USBF.CAL  will  be  written  from  the  coded  information  in  the 
accompanying  equation  spreadsheet  USBFEQ.CAL.  Figure  6  shows  part  of  the 
equation  specification  spreadsheet  USBFEQ  accompanying  the  spreadsheet 
USBF. 10 

The  equation  spreadsheet  holds  equation  terms  in  cells  for  every  variable 
requiring  an  equation  in  a  model  spreadsheet.  Explanatory  variables  for 
equations  are  found  in  columns  C  through  AN.  These  explanatory  variables  may 
be  contained  in  the  model  spreadsheet  itself,  or  they  may  be  contained  in 
other  model  spreadsheets.  Variables  calculated  by  equations  are  represented 
by  variable  names  in  rows  6  through  43  of  column  A.  Looking  at  figure  6,  rows 
1  and  2  contain  descriptive  variable  names  and  units,  respectively,  which  are 
used  for  reference  purposes  only.  Row  3  contains  the  key  model  variable  names 
that  are  used  by  DWOPSIM  programs.  The  variable  names  have  a  specific  format 
"SSvVC"  where  SS  is  the  name  of  the  spreadsheet  containing  the  variable,  v  is 


Figure  6 --Part  of  the  USBFEQ.CAL  equation  spreadsheet  for  the  model  TIME 
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9 

BFqlM  E 

< — there  is 

one  row  for 

multiply 

column  (E) 

*v 

10 

BFqEX  F 

each  equation  in  the 

*v 

11 

BFqCN  G 

USBF  spreadsheet 

12 

BFqES  H 

*v 

13 

10Equation  spreadsheet  names  take  the  name  of  the  model  spreadsheet 
appended  with  the  suffix  EQ.  A  listing  of  an  equation  spreadsheet  for  the 
model  TIME  can  be  found  in  appendix  2. 
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the  general  type  of  variable,  and  VC  is  a  variable  name  code  (see  appendix  2 
for  a  brief  explanation  of  these  codes).  Row  4  contains  the  letter  of  the 
column  in  the  model  spreadsheet  where  the  data  for  the  variable  resides.  Cell 
B2  gives  the  row  number  in  the  model  spreadsheet  that  contains  the  data  to  be 
used  as  the  base  year  values  for  model  initialization.  The  information  in 
rows  3  and  4  is  key  to  the  operation  of  DWOPSIM  model  building  programs. 

Nomenclature  conventions  used  in  rows  3  and  4  of  the  equation  spreadsheet  must 
follow  DWOPSIM  conventions.  The  name  of  the  model  spreadsheet  containing 
equations  to  be  modeled  (such  as  USBF)  requires  four  letters.  The  name  of  the 
model  spreadsheet  MUST  be  located  in  cell  A1  (right  justified)  in  the  equation 
spreadsheet  and  the  appendix  EQ  MUST  be  (left  justified)  in  cell  B1 .  The  name 
of  the  model  spreadsheet  containing  a  variable  MUST  be  the  first  part  of  the 
variable  name  in  row  3  of  the  equation  spreadsheet.  Model  spreadsheets  that 
have  no  equations  (only  exogenous  data),  must  have  a  two-letter  name  (such  as 
US)  . 

An  example  can  be  given  for  BF  production  in  column  E  of  the  equation 
spreadsheet  USBFEQ.CAL  (fig.  6).  The  variable  is  given  the  name  USBFqPR, 
which  means  that  the  variable  for  the  quantity  (q)  of  beef  production  (PR)  is 
found  in  column  D  of  the  model  spreadsheet  USBF  (fig.  2).  Column  C,  row  3  of 
USBFEQ.CAL  in  figure  6  gives  the  name  USBFnSL  for  US  beef  slaughter  numbers 
and  row  4  says  that  this  variable  will  be  found  in  column  B  of  the  spreadsheet 
USBF. CAL. 

The  cells  below  row  5  of  the  equation  spreadsheet  contain  the  equation 
specification  and  parameters  for  the  variable  term  (column)  as  it  appears  in 
the  equation  (row) .  The  equation  for  a  variable  is  simply  the  concatenation 
of  all  of  the  column  terms  in  an  equation  row  (the  name  of  the  variable  to  be 
explained  by  the  equation  is  found  in  column  A  of  the  equation  row) .  If  a 
cell  is  blank,  as  is  the  case  with  many  cells  in  the  figure  6,  this  means  that 
the  variable  represented  by  the  cell  column  does  not  appear  in  the  equation 
for  the  variable  equation  in  that  row.  If  the  cell  contains  information,  it 
contains  a  "v,"  which  means  that  the  variable  in  that  column  is  to  be  used  as 
an  equation  term  with  whatever  arithmetic  is  found  in  the  cell.  For  example, 
in  figure  5,  cell  E7  contains  the  code  "*v."  This  means  that  the  product  (*) 
of  this  variable  (US  beef  production  =  USqPR)  is  to  used  as  a  term  in  the 
equation  calculating  the  slaughter  weight  of  US  beef  (BFrSW) .  An  examination 
of  the  entire  row  of  an  equation  for  a  variable  will  illustrate  the  idea  for  a 
full  equation,  but  that  requires  a  listing  of  all  the  terms  making  up  an 
equation  (see  appendix  2). 

Because  the  equation  spreadsheet  is  so  important,  a  special  output  program 
DWOPEOUT  is  available  to  print  out  all  of  the  information  in  the  spreadsheet 
in  full  in  a  readable  format.  Screen  3  shows  the  screen  seen  when  the 
DWOPEOUT  program  is  invoked.11  Note  that  if  the  P  (print)  option  is  chosen, 
the  program  calls  a  batch  program  HPLASER,  which  sets  a  small  print  on  an  HP 
laser  printer.  The  software  Laser  Control  is  used  for  printing  the  small 
print  in  this  report  for  the  model  TIME.  A  file  PORTSMAL  set  in  the  software 


11DWOPSIM  program  conventions  follow  those  used  in  the  SWOPSIM  modeling 
framework.  If  a  user  is  unsure  of  what  a  program  does,  typing  the  name  of  the 
program  (without  the  model  or  variable  names  it  asks  for)  will  bring  up  the 
screen  explaining  the  program.  These  screens,  along  with  a  full  program 
listing  for  all  programs,  are  found  in  appendix  3. 
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package  defines 
the  small  print. 

If  a  user  does  not 
have  this 
software,  other 
laser  printer 
control  programs 
may  do  the  job  and 
their  calling 
programs  should 
replace  HPLASER  in 
DWOPSIM  output 
programs . 

Alternatively,  the 
user  may  select 
the  F  option,  and 
print  ASCII  files 
to  the  D:  drive, 
and  use  SIDEWAYS 

or  some  other  printing  routine  to  print  the  results  in  a  readable  format. 

Figure  7  gives  part  of  this  full  printout  for  row  8  of  the  file  USBFEQ.CAL 
(see  fig.  6),  which  contains  the  equation  terms  for  the  variable  BFqPR,  the 
quantity  of  beef  produced  in  the  US.  The  bottom  of  figure  7  shows  the  full 
equation  in  terms  of  the  variable  names  (partially  shown  in  row  3  of  figure 
6) .  This  full  equation  for  the  US  for  BFqPR  used  a  standard  equation 
notation,  which  is  based  on  SuperCalc  5  mathematical  operations  notation  (*  = 
multiply,  /  =  divide,  A  =  exponentiation).  In  effect,  when  the  blank  cells 
are  removed,  the  equation  is  a  constant  plus  a  string  of  the  remaining  cells 
in  the  row.  The  equation  at  the  bottom  of  figure  7  also  illustrates  how 
lagged  variables  are  marked  in  the  equation  spreadsheet.  The  first  three 
terms  in  the  equation  are  producer  incentive  prices  (PI)  found  in  the 
commodity  spreadsheet  USBF  for  the  US.  The  first  price  term  is  the  current 
price,  while  the  second  and  third  are  lagged  prices  where  the  period  of  lag  is 
indicated  by  an  appended  1  or  2 ,  respectively,  to  the  explanatory  variable 
name.  The  last  term  in  the  equation  is  a  growth  term  where  0.0116  is  the 
supply  growth  rate  and  WDeTM  is  the  time  trend  variable  found  in  the  world 
(WD)  spreadsheet.  The  constant  term  in  an  equation  does  not  appear  in  the 
equation  spreadsheet.  It  is  calculated  and  placed  in  the  actual  equation  in 
the  model  spreadsheet  when  the  spreadsheet  is  initialized  to  base  period  data. 

The  specification  shown  in  figure  7  also  shows  linkages  to  other  model 
spreadsheets,  specifically  the  US  country  spreadsheet  (fig.  4)  that  contains 
real  income  (USeIN)  and  population  (USePP) ,  which  are  required  as  explanatory 
variables.  A  linkage  to  the  USCN  model  spreadsheet  also  occurs  where  the 
consumer  price  for  corn  (USCNpCN)  is  required  as  an  explanatory  variable  with 
a  demand  elasticity  of  -0.05.  Finally,  a  linkage  to  the  world  (WD)  reference 
price  spreadsheet  containing  real  prices  (fig.  5)  and  time  trend  (TM)  variable 
occurs  via  the  variable  WDeTM. 

From  a  practical  point  of  view,  the  lined  printouts  of  the  equation 
spreadsheets,  printed  by  DWOPEOUT  (as  shown  in  appendix  2  for  the  model  TIME), 
give  all  the  information  about  equations  in  model  spreadsheets.  Furthermore, 
these  printouts  can  serve  as  worksheets  if  equations  are  to  be  modified 
because  it  is  easy  to  read  equation  terms  handwritten  on  the  printouts  and 
enter  them  into  the  equation  specification  spreadsheets.  Control  of  equations 


Screen  3 --The  program  DWOPEOUT 


DWOPSIM  Output  Program 


DWOPEOUT  Program  to  print  two  pages  of  a  DWOPsim  Equation  and 

parameter  spreadsheet  OUTput  FILE  as  well  as  a 
third  page  of  model  equations. 

REQUIREMENTS  DWOPSIM  equation  spreadsheet  file  (FILEEQ.CAL) 

on  NAME  model  subdirectory.  The  template  file  DWOPEOUT. CAL 
must  be  available  on  the  DWOPSIM  subdirectory.  The  print 
(P)  option  assumes  an  HPLASER  batch  program  calling  a 
PORTSMAL  configuration  file  for  the  Laser  Control  program. 

OUTPUT  (D:)  Print  two-page  file  on  printer  (P  option)  or  on  D:  (with 
F  option)  and  a  FILEEOUT.CAL  on  D: .  Print  one  page  of 
model  variable  names  and  equations  (on  printer  or  on  D:). 


COmAND  DWOPEOUT  NAME  FILE  P  (or  F) 
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Figure  7 --Row  for  variable  BFqPR  from  the  equation  spreadsheet  USBFEQ 
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is  totally  maintained  by  the  information  inserted  into  the  equation 
specification  spreadsheet.  DWOPSIM  programs  transform  the  equation 
spreadsheet  information  into  actual  equations  in  the  model  spreadsheets.  This 
will  be  discussed  later,  but  we  must  discuss  policy  and  exogenous  data  first. 
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Policy  and  Exogenous  Data  in  Model  Spreadsheets 


A  model  spreadsheet  contains  historical  and  projected  data.  It  is  the 
repository  for  historical  data  for  a  model.  With  current  formatting, 
historical  data  can  begin  from  1960.  While  historical  data  are  useful  for 
econometric  analysis,  the  only  historical  data  absolutely  required  for 
simulation  modeling  are  data  with  enough  years  to  account  for  lagged  variables 
required  in  an  equation.  Then,  there  are  the  variables  to  be  explained  into 
the  future.  This  may  be  done  with  equations  relating  particular  variables  to 
other  variables  in  the  host  model  or  other  model  spreadsheets.  Projected 
variables  may  also  be  entered  exogenously,  or  they  may  be  calculated  by 
equations  (identities)  manually  entered  into  the  spreadsheet.  But,  projected 
numbers  are  required  for  (exogenous)  variables  that  are  used  in  simulation 
equations;  these  numbers  often  are  policy  variables  or  exogenous  data,  from  a 
modeling  viewpoint.  All  of  these  data,  no  matter  how  they  are  generated,  can 
be  printed  out  by  the  program  DWOPBOUT  (screen  4) .  Again,  if  an  HP  laser 
printer  is  attached  and  the  appropriate  INSIGHT  software  is  used,  DWOPBOUT 
will  print  out  a  page  of  condensed  print.  If  the  "F"  print  to  disk  option  is 
invoked,  the  user  can  obtain  a  print  copy  by  some  other  means. 

Figure  8  shows  part  of  the  data  printout  from  the  program  DWOPBOUT  for  the 
model  spreadsheet  USBF  from  the  DWOPSIM  demonstration  model  TIME.  Several 
points  concerning  prices,  net  trade,  and  policy  price  wedges  can  be 
illustrated  with  the  data  shown.  Net  trade  is  a  variable  generated  with  an 
"in  spreadsheet"  formula  for  both  historical  and  future  periods;  net  trade  is 
an  identity  and  does  not  require  an  explanatory  equation  with  an  intercept. 
This  illustrates  the  point  that  formulas  for  variables  not  requiring  constant 
terms  can  be  put  into  spreadsheets  manually.  The  other  data  in  figure  8  do 
not  exist  in  the  model  prior  to  1989.  But  as  long  as  simulations  into  the 
future  for  any  variable  do  not  require  these  variables  (lagged)  prior  to  1989, 
simulation  will  be  possible.  Finally,  some  of  the  data  are  "policy"  data, 
which  are  used  to  emulate  policy  changes  over  time.  In  the  case  of  BFwCS,  a 
consumer  subsidy  wedge,  the  numbers  decline  over  time  and  are  simply  a  base 
period  number  projected  into  the  future  with  a  deflation  formula. 

The  flexibility  of  the  spreadsheet  enters  into  full  force  in  these  model 
spreadsheets.  Spreadsheet  formulas  can  be  used  to  generate  data  if  that  is  a 
desirable  way  to  go.  Data  can  be  prepared  externally  to  the  model 
spreadsheets  and  can  be  entered  manually  or  by  user-designed  programs. 

Screen  4- -The  program  DWOPBOUT 


DWOPSIM  Output  Program 

DWOPBOUT  Program  to  print  a  page  of  a  DWOPsim  Base  data  spreadsheet 

OUTput . 

REQUIREMENTS  DWOPSIM  model  spreadsheet  with  assumed  FILE  name  (e.g. 

USBF. CAL)  on  NAME  model  subdirectory.  The  template  file 
DWOPBOUT. CAL  must  be  available  on  the  SWOPSIM  subdirectory. 
The  print  (P)  option  assumes  an  HPLASER  batch  program 
calling  a  PORTSM97  configuration  file. 

OUTPUT  (D:)  Print  1  page  file  on  D:  (with  P  option)  or  on  D:  (with  F 
option)  and  a  FILEBOUT.CAL  on  D: 

COMMAND  DWOPBOUT  NAME  FILE  P  (or  F) 


In  the  case  of 
identities  that  do 
not  require 
constant  terms, 
two  options  are 
available . 

Formulas  can  be 
entered  manually 
into  model 
spreadsheets,  or 
they  can  be  coded 
as  equations  in 
equation 

spreadsheets  to  be 
written  into  the 
model  spreadsheets 
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Figure  8--Part  of  the  model  spreadsheet  USBF 
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when  they  are  initialized  by  the  program  DWOPINIT. 

Once  model  spreadsheets  contain  historical  data  and  any  generated  variables 
required  for  simulation  past  a  model  base  period,  the  user  is  ready  to 
initialize  model  spreadsheets.  All  of  the  required  DWOPSIM  operations  for 
data  preparation  could  be  done  manually.  Alternatively,  if  an  appropriate 
TSView  supply  and  utilization  database  is  available,  DWOPSIM  programs  could 
automate  some  of  the  more  difficult  parts  of  data  preparation.  Exogenous 
projected  data  and  derived  variables  will  have  to  be  entered  manually. 

Once  data  entry  is  completed,  programs  such  as  DWOPEOUT  and  DWOPBOUT12  are 
available  to  print  out  compact  readable  versions  of  the  model  spreadsheets. 


12DW0PE0UT  also  prints  a  page  listing  model  spreadsheet  variables  and  the 
equations  contained  in  the  spreadsheet  using  variable  names  found  at  the  top 
of  the  equation  spreadsheet.  These  "equations"  (identical  to  the  one  seen  at 
the  bottom  of  figure  7  and  listed  in  full  for  the  model  TIME  in  an  appendix) 
serve  as  the  mathematical  documentation  of  a  model. 
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Initialization  of  a  Model  Spreadsheet 

Given  a  coding  of  equations  structure  and  parameters  in  the  equation 
spreadsheet,  the  next  step  is  to  have  equations  generated  for  years  beyond  the 
base  period  in  the  model  spreadsheet.  This  converts  the  model  spreadsheet 
from  a  data  repository  into  a  spreadsheet  with  equations  explaining  selected 
variables  as  a  function  of  variables  in  the  host  and  other  model  spreadsheets. 

The  program  DWOPINIT  writes  equations  and  calculates  intercepts  (constant 
terms)  that  make  the  equations  replicate  base  year  data.  Screen  5  shows  the 
program  DWOPINIT.  Once  the  program  has  been  run  for  a  model  (country  and 
commodity,  in  case  of  the  demonstration  model  TIME),  it  leaves  the  spreadsheet 
operated  upon  as  well  as  spreadsheets  linked  to  it  by  equations  on  the  D: 
drive.  These  spreadsheets  must  be  manually  copied  to  the  model  subdirectory 
for  permanent  safekeeping. 

The  equations  are  written  into  the  model  spreadsheet  in  simple  formula,  using 
spreadsheet  cell  notation  to  refer  to  variables.  The  bottom  line  of  figure  9 
shows  the  formula  appearing  in  cell  D36  of  the  spreadsheet  USBF  that  was 
written  out  by  the  DWOPINIT  program.  The  first  thing  to  notice  about  the 
equation  is  that  variables  are  now  cell  references  in  the  USBF  spreadsheet  or 
cell  references  in  other  spreadsheets  (the  cell  reference  then  is  preceded  by 
the  spreadsheet  name  and  a  "!"  mark).  For  example,  the  term  USCN1T36  refers 
to  the  variable  in  cell  T36  of  the  spreadsheet  USCN.  The  cross  spreadsheet 
linkage  capability 
of  SuperCalc  5 
allows  equations 
to  include  terms 
that  are  linkages 
to  other 
spreadsheets . 

Also  notice  that 
the  constant  term 
is  a  number.  This 
is  calculated  by 
the  DWOPINIT 
program  from  the 
equation  itself 
and  the  base 
period  data 
(recall  that  the 
base  period  is 
selected  in 
USBFEQ. CAL  by 
marking  the  base 
period  row  in  cell 
B2)  and  is 
inserted  at  the 
beginning  of  the 
equation.  The 
arithmetic  in  the 
equation  uses  the 
notation  of 
formulas  in  the 
SuperCalc  5 
spreadsheet . 


Screen  5- -Program  DWOPINIT  for  initialization  of  a  model 
spreadsheet 


DWOPSIM  Program 


DWOPINIT  Program  to  INITialize  equations  in  a  model  spreadsheet, 

given  the  equation  cell  components.  Equations  with  a 
calculated  constant  term  are  inserted  from  the  base  period 
forward.  A  FILE  name  is  assumed  for  the  model 
spreadsheets  (e.g.  USBF. CAL). 

REQUIREMENTS  A  C:\NAME  subdirectory  must  contain  the  model  spreadsheet 
FILE  and  the  FILEEQ  equation  specification  spread¬ 
sheet.  The  equation  writing  spreadsheet  must  exist  on  the 
C:\DWOPSIM  subdirectory. 

OUTPUT  (D:)  The  initialized  spreadsheet  FILE  on  D:. 


COMAND  DWOPINIT  NAME  FILE 


Figure  9 --Equation  for  BFqPR  in  model  spreadsheet  USBF 
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Every  time  a  data  number  or  equation  structure  or  parameter  is  changed  in  a 
model  spreadsheet  for  a  country,  DWOPINIT  must  be  run  to  update  the  equations 
and  recalculate  the  constant  term.  If  there  are  many  model  spreadsheets  for 
many  products  and  countries,  a  batch  program  that  loops  through  all  the  model 
spreadsheets  containing  equations  calling  DWOPINIT  should  be  prepared.  The 
demonstration  program  TIME  has  a  batch  program  TIMELOOP  that  does  this  kind  of 
looping  operation. 

Some  model  spreadsheets  may  contain  only  exogenous  data  and  no  equations  need 
to  be  written.  In  this  case,  there  will  be  no  accompanying  equation 
spreadsheet  nor  any  need  to  run  DWOPINIT.  The  country  spreadsheets  US,  EC, 
and  RW  in  the  model  TIME  are  examples  of  these  "equation- less"  spreadsheets. 


Assembly  of  Model  Spreadsheets  Into  a  World  Model  Linked  in  Memory 

When  the  model  spreadsheets  (such  as  product,  country,  and  world  spreadsheets 
in  the  demonstration  model  TIME)  have  all  been  prepared  and  initialized,  the 
user  runs  the  DWOPSIM  program  DWOPSOLV.  This  program,  shown  in  screen  6, 
calls  up  the  equation  parts  (as  well  as  the  required  exogenous  data  in  the 
model  spreadsheets)  and  places  them  in  computer  memory.  DWOPSOLV  also  gets 
the  world  reference  price  spreadsheet,  adds  a  world  market-clearing  mechanism 
template,  and  places  this  new  world  spreadsheet  into  memory.  This  is  done  in 
a  manner  that  maintains  linkages  across  spreadsheets.  When  DWOPSOLV  has 
completed  model  assembly,  the  screen  will  show  a  message  telling  the  user  to 
press  "Enter"  to  gain  control  of  the  world  model.  At  this  point,  the  model  is 
ready  to  solve.  When  "Enter"  is  pressed,  the  user  will  observe  a  split  screen 
centered  on  parts  of  the  world  market  solution  and  reference  price 
spreadsheet.  The  cursor  can  be  moved  to  observe  different  parts  of  the 
spreadsheet  on  the  screen.  Entering  will  toggle  the  cursor  between  the 
two  screen  parts.  The  screen  size  has  been  set  for  zoom,  which  uses  small 

Screen  6- -Program  DWOPSOLV  to  assemble  a  world  model  from 
individual  model  spreadsheets 


DWOPSIM  World  Model  SOLVer  Assembly  Program 


DWOPSOLV  Program  to  assemble  a  DWOPSIM  world  model  in  memory  and 

prepare  it  for  SOLVing.  A  macro  is  also  created 
which  can  be  used  to  save  the  results  on  D:  after  the 
model  is  solved.  Type  ALT-S  to  invoke  the  ’save’  macro. 

The  model  can  be  solved  again  with  the  program  NAMEAGAN . 

REQUIREMENTS  DWOPSIM  model  spreadsheets  in  the  NAME  subdirectory.  A 
1  Digit  letter  or  number  must  be  selected  to  mark  the 
solution  value  files  saved  on  D:  This  program  also 
requires  that  a  model  specific  batch  file  has  to  have 
been  created  and  saved  on  the  batch  subdirectory  (under 
the  name  NAMESOLV.BAT).  This  file  tells  DWOPSOLV  what 
model  files  comprise  the  global  model  to  be  assembled. 

A  WDS.CAL  world  solution  mechanism  file  must  have  been 
created  on  the  NAME  subdirectory. 

OUTPUT  (D:)  Linked  files  in  memory  for  the  model  NAME,  ready  for 

SOLVing.  If  the  ALT-S  macro  is  invoked  after  the  model  is 
solved,  D:  will  contain  solution  value  files  appended  with 
the  selected  Digit  (e.g.  if  D=1  for  USBF,  file  is  USBF.S1). 


COMMAND  DWOPSOLV  NAME  D 


print  to  give  a 
larger  picture  of 
action  on  the 
screen.  The 
computer  commands 
(CNTL+)  or  (CNTL-) 
will  toggle 
through  the 
spreadsheets  held 
in  memory.  Note 
that  when  DWOPINIT 
is  invoked,  the 
user  must  enter  a 
one -digit/letter 
code  to  mark  the 
solution  when  it 
is  saved  with  the 
ALT-S  command. 

This  gives  the 
user  markings  for 
up  to  36  solutions 
for  one  assembled 
world  model. 
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Simulation  of  a  DWOPSIM  World  Model  and  the  Reporting  of  Simulation  Results 

The  top  part  of  figure  10  shows  the  message  telling  the  user  to  proceed,  and 
the  bottom  part  shows  the  screen  the  user  sees  when  the  world  model  is  ready 
to  be  solved.  At  this  point,  the  user  may  manually  change  exogenous  or  policy 
data  to  shock  the  model .  This  may  be  done ,  for  example ,  by  manually  changing 
projected  (baseline)  values  of  policy  variables  or  by  changing  intercept  shift 
terms  if  they  have  been  entered  as  equation  variables.  When  preparation  is 
done  in  the  appropriate  model  spreadsheets  in  memory,  the  global  system  can  be 
solved. 


Once  the  recalculation  command  is  issued  (by  pressing  F9) ,  the  set  of 
spreadsheets  in 

memory  will  Figure  10- -Screens  showing  the  world  model  is  ready  to  solve 

solve 

simultaneously 
until  world 
markets  are 
cleared  by  the 
world  market¬ 
clearing 
mechanism  now 
added  to  the 
WD . CAL 

spreadsheet  in 
memory.  This 
solution 

mechanism  has  to 
be  manually 
constructed 
prior  to 
solution  and 
saved  in  the 
model 

subdirectory  as 
a  WDS.CAL  file. 

In  the  case  of 
the 

demonstration 
model  TIME,  this 
mechanism 
changes  world 
prices  for  BF 
and  CN  in  all 
time  periods 
following  the 
base  period 
until  world 
trade  equals 
zero  for  BF  and 
CN  in  all  time 
periods . 


Once  the  model 
has  begun 
solving,  the 
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Once  DW0PS0LV  is  done  with  model  assembly,  the  user  sees  this  screen 
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The  top  half  of  the  screen  shows 
the  solution  weights  for  the  model 
TIME  in  row  67  and  the  world 
prices  being  calculated  below  row 
69.  The  user  can  manually  provide 
shocks  to  spreadsheets  in  memory 
and  press  F9  to  begin  solving  the 
world  model  system. 
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The  bottom  half  of  the  spreadsheet 
on  the  screen  contains  the 
calculated  net  trade  for  BF  and  CN 
for  the  world  model  TIME.  When 
F9  is  pressed  to  calculate  the 
spreadsheet,  the  NA’s  will  be 
replaced  by  numbers  which  should 
iterate  to  zero  as  the  solution 
of  the  world  model  in  memory 
proceeds.  Touching  any  key  will 
stop  the  solution  process  and 
pressing  F9  will  start  it  again. 


The  user  can  move  the  cursor 
from  this  half  of  the  spreadsheet 
to  the  top  half  by  pressing 
Spreadsheets  in  memory  can  be 
toggled  to  by  pressing  CNTL  - 
or  CNTL  +. 


When  the  world  market  is  cleared 
(world  net  trade  for  BF  and  CN 
equals  zero  for  all  time  periods), 
the  user  can  press  ALT  S  to  save 
the  solution  spreadsheets  on  D:. 
They  will  be  marked  by  an 
appendix  SD  (e.g.  for  solution  7, 
the  USBF  solution  would  be 
USBF.S7) . 


Memory:  1941  Last  Col/Row :D133 
READY  Fl:Help  F3:Names  Ctrl-Backspace :Undo  Ctrl-Break : Cancel  CAPS  CALC 
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user  can  let  it  complete  solution  by  itself  or  he  may  want  to  visually  check 
net  world  trade  figures  for  progress  in  moving  toward  zero.  The  solution 
mechanism  shown  for  the  demonstration  model  TIME  does  have  damping  factors 
that  can  be  adjusted  for  each  product  to  control  the  world  reference  price  and 
net  trade  swings  (see  fig.  10).  These  parameters  are  found  in  the  world 
market-clearing  template  with  the  name  WDS.CAL  associated  with  each  model. 

The  market- clearing  mechanism  for  the  model  TIME  itself  is  similar  to  that  of 
SWOPSIM  where  world  prices  are  changed  depending  upon  world  net  trade 
balances.  When  world  net  trade  is  zero  for  all  products,  world  prices  do  not 
change  anymore  and  the  model  is  solved. 

When  an  acceptable  solution  has  been  reached,  the  user  must  type  in  "ALT-S"  to 
execute  a  macro  that  saves  the  solution  values  for  each  component  spreadsheet 
of  the  world  model  on  the  D:  drive.  This  solution  can  be  viewed  at  will  and 
should  be  saved  to  the  model  subdirectory  for  safekeeping  and  later  analysis. 
The  solution  spreadsheets  are  labeled  with  the  spreadsheet  name  with  an 
appendix,  which  is  S  followed  by  a  number  or  digit  marking  the  solution.  This 
number  or  digit  was  entered  when  the  program  DWOPSOLV  was  invoked.  Once  the 
solution  has  been  saved  in  memory,  programs  are  available  to  examine  the 
output . 13 

The  program  DWOPSOLV  itself  calls  a  model  specific  solution  program  that  must 
be  prepared  for  each  model.  In  the  case  of  the  model  TIME,  this  program  on 
the  batch  subdirectory  has  the  name  TIMESOLV.  As  was  the  case  with  DWOPTIME, 
the  program  TIMESOLV  can  be  edited  to  suit  the  coverage  of  a  different  DWOPSIM 
model.  See  appendix  3  for  a  listing  of  DWOPSOLV.  DWOPSOLV  also  calls  a 
program  DWOPWDS ,  which  adds  the  world  market-clearing  mechanism  in  the 
spreadsheet  WDS.CAL  to  the  WD.CAL  world  spreadsheet  in  memory. 

If  the  user  does  not  want  to  save  the  simulation,  the  normal  SuperCalc  5 
commands  //SQ,Y  will  exit  the  model  spreadsheets  in  memory.  When  either  the 
solution  has  been  saved  on  D:  (by  the  ALT  S  command)  or  the  world  model  has 
been  exited  (via 
the  //SQ, Y 
SuperCalc  5 
sequence) ,  the 
user  has  the 
option  of 
obtaining  OTHER 
solutions  by 
running  a  model 
specific  *AGAN 
program.  In  the 
case  of  the  model 
TIME,  this  program 
is  TIMEAGAN.  It 
takes  the  model 
files  that 
DWOPSOLV  had 
prepared  for 


13Imagination  in  examining,  manipulating,  and  presenting  output  results 
is  largely  up  to  the  model  builder.  Spreadsheets  are  a  very  good  medium  for 
this  purpose  because  spreadsheet  templates,  which  reach  into  solution  and 
history /baseline  spreadsheets,  can  be  constructed  to  aid  in  this  process. 


Screen  7 --The  program  DWOPCVAR 


DWOPSIM  Output  Program 


DWOPCVAR  Program  to  compare  up  to  four  solution  VALues  with  baseline 

and  historical  values  for  a  selected  spreadsheet  variable 
(Column)  in  a  model  spreadsheet  FILE  (e.g.  USBF). 

REQUIREMENTS  DWOPSIM  spreadsheet  and  solution  spreadsheet(s)  on  NAME 
model  subdirectory.  The  template  file  DWOPCVAR. CAL 
must  be  available  on  the  DWOPSIM  subdirectory. 

If  the  printout  is  invoked  from  the  output  spreadsheet, 
an  HPLASER  batch  program  calling  a  PORTSMAL  configuration 
file  for  the  Laser  Control  program  is  assumed  available. 

OUTPUT  (D:)  Comparisons  on  screen  (spreadsheet  with  graph  in  it) 


COMMAND  DWOPCVAR  NAME  FILE  C  SI  S2  S3  SA 
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simulation  and  saved  on  D:  and  re-installs  them  into  memory  for  another 
solution  scenario.  This  process  can  be  continued  indefinitely,  depending  on 
room  for  storage  of  the  solution  values. 

Once  simulation  results  have  been  saved,  three  programs  are  available  to 
examine  and  report  simulation  results.  Screen  7  shows  the  screen  for  the 
program  DWOPCVAR,  which  compares  variables  for  up  to  four  solutions  with 
historical/baseline  data. 

Part  of  the  spreadsheet  created  by  DWOPCVAR  is  shown  in  figure  11.  This 
spreadsheet  can  be  printed  out  by  executing  the  macro  shown  at  the  bottom  of 
the  figure  (use  ALT-F5) .  The  template  spreadsheet  DWOPCVAR. CAL  on  the 
C:\DWOPSIM  subdirectory,  formats  the  output  data  and  graphics.  Figure  12 
shows  the  graphical  output  contained  in  the  spreadsheet  created  by  DWOPCVAR. 
Again,  the  format  and  contents  of  the  graph  are  created  in  the  template 
spreadsheet  DWOPCVAR. CAL.  This  illustrates  the  general  method  of  reporting 
results,  which  is  to  create  small  programs  and  templates  to  retrieve  and 
create  the  desired  output.  Because  the  solutions  and  historic  or  baseline 
data  are  in  spreadsheets,  all  forms  of  reports  and  graphics  can  easily  be 
created  by  the  user.  This  can  include  the  conversion  of  SuperCalc  5 
spreadsheet  output  into  formats  readable  by  other  spreadsheets.14 

In  figure  12,  the  solution  files  have  been  marked  by  the  digit  "7"  and  the 
plot  shows  the  projection  of  US  beef  production  for  history  (1960-91)  and  the 
base  projection  and  alternative  solution  "7"  from  1992  to  2020.  The  C:\TIME 
subdirectory  has  a  series  of  commodity  files  with  labels  USBF7 ,  USCN7,  etc., 
which  contain  the  solution  data.  The  "7"  solution  shows  the  value  of  US  beef 
production  when  world  markets  have  cleared,  while  the  baseline  is  simply  the 
trend  value  of  production.  Normal  procedure  would  be  to  substitute  a  baseline 
figure  created  when  world  markets  cleared  and  then  do  alternative  scenarios 
from  the  "globally  balanced"  baseline. 

Solution  output 
can  be  printed  in 
the  same  format  as 
historical  and 
baseline  data  with 
the  program 
DW0PS0UT .  The 
output  is  in 
exactly  the  same 
format  as  that 
produced  by 
DWOPBOUT  (see 
output  of  DWOPBOUT 
in  fig.  8  and  app . 

2) .  Screen  8 
shows  the  screen 
seen  if  DWOPSOUT 
program  is 
executed  without 


Figure  11- -Part  of  an  output  spreadsheet  created  by 
DWOPCVAR 
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14SuperCalc  can  output  LOTUS  spreadsheets  as  an  option.  LOTUS 
spreadsheets  are  readable  by  most  spreadsheet  programs  and  many  graphics 
presentation  packages  such  as  Harvard  Graphics. 
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Figure  12- -Graphical  output  from 
DWOPCVAR 


providing  parameters  for  it.  The 
printed  data  series  for  both  DWOPSOUT 
and  DWOPBOUT  go  from  1960  to  2005  in 
order  to  get  everything  on  one  page 
with  reduced  print.  Of  course,  this 
option  could  be  changed  by  changing 
parameters  in  the  programs  and 
relevant  spreadsheet  templates. 

Another  useful  output  routine , 
DWOPCSOL,  is  similar  to  DWOPCVAR. 
DWOPCSOL  produces  a  spreadsheet  and 
graph  of  up  to  four  variables  from  a 
model  solution  spreadsheet.  It  is 
useful  for  looking  at  graphs  of  a  set 
of  variables,  compared  with  history 
and  baseline  in  a  model  spreadsheet. 
Screen  9  shows  the  screen  seen  when 
DWOPCSOL  is  invoked  without  any  of  the 
required  parameters. 


If  DWOPSIM  proves  to  be  a  practical 

vehicle  for  baseline  work,  projections,  and  time  series  modeling,  users  will 
use  the  simple  techniques  of  DWOPCVAR,  DWOPSOUT,  and  DWOPCSOL  to  develop  other 
output  routines.  All  of  these  programs  are  simply  DOS  batch  programs,  which 
manipulate  model  spreadsheets  and  spreadsheet  templates  that  format  the 
output . 


Concluding  Comments 


The  building  blocks 
This  is  because  the 
builder  is  not 
built  into  the 
DWOPSIM  framework 
itself  as  was  the 
case  with  SWOPSIM. 
This  means  that 


of  DWOPSIM  are  simple  compared  with  those  of  SWOPSIM  (6)  . 
large  issue  of  model  specification  for  the  DWOPSIM  model 


Screen  8 --The  program  DWOPSOUT 


DWOPSIM  Output  Program 


there  are  fewer 
programs  and 
procedures  to  deal 
with,  but  it  also 
means  that  the 
DWOPSIM  user  will 
have  to  cope  with 
the  unique  and 
complex  problems 
that  come  with 
building  a 
solvable  and  well- 
behaved  time 
series  model.  Many 


DWOPSOUT  Program  to  print  a  page  of  a  DWOPsim  Solution  from  a  model 

spreadsheet  OUTput  FILE. 

REQUIREMENTS  DWOPSIM  model  spreadsheet  solution  FILE  on  model 

subdirectory  (NAME).  The  solution  spreadsheet  will  have 
the  suffix  * . SD  where  D  is  1  Digit  solution  marker. 

A  spread  model  name  (FILE)  is  assumed.  The  template  file 
DWOPSOUT. CAL  must  be  available  on  the  SWOPSIM  subdirectory. 
The  print  (P)  option  assumes  an  HPLASER  batch  program 
calling  a  PORT SM 9 7  configuration  file  for  the  Laser  Control 
program. 

OUTPUT  (D:)  Print  1  page  file  on  D:  (with  P  option)  or  on  D:  (with  F 
option)  and  a  FILESD.CAL  on  D: 


COMMAND  DWOPSOUT  NAME  FILE  D  P  (or  F) 


of  the  DWOPSIM 
conventions  were 
derived  from 
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Screen  9 --The  program  DWOPCSOL 


DWOPSIM  Output  Program 

DWOPCSOL  Program  to  Compare  up  to  4  variables  in  a  SOLution  with 

historical/baseline  values.  Variables  (Columns)  are  in 
a  model  FILE  (e.g.  USBF)  and  solution  values  are  in  a 
solution  file  (e.g.  USBF.SD)  where  D  marks  the  solution. 

REQUIREMENTS  DWOPSIM  model  spreadsheet  and  solution  spreadsheet (s )  on 
model  subdirectory.  The  template  file  DWOPCSOL. CAL 
must  be  available  on  the  DWOPSIM  subdirectory. 

Printing  (an  option  from  the  comparison  spreadsheet) 
assumes  an  HPLASER  batch  program  calling  a  PORTSMAL 
configuration  file  for  the  Laser  Control  program. 

OUTPUT  (D:)  Comparisons  on  screen  (spreadsheet  with  graph  in  it) 

CC*«AND  DWOPCSOL  NAME  FILE  D  Cl  C2  C3  C4 


has  been 

formulated  to  use  two-digit  country  and  commodity  codes  (such  as  the  SWOPSIM 
1989  TSView  database  (7)),  DWOPSIM  programs  are  available  to  prepare  globally 
balanced  sets  of  supply  and  utilization  data  for  products  defined  in  the 
TSView  database.  This  process  creates  DWOPSIM  product  spreadsheets  similar  to 
the  TSView  database  format. 

Other  data  (not  from  TSView)  needed  for  modeling  in  a  world  model  must  be 
found  and  entered  manually  into  appropriate  spreadsheets.  A  world  market¬ 
clearing  mechanism  must  be  created  as  well.  The  user  is  free  to  design  the 
spreadsheet  structure  of  a  model,  or  the  user  can  proceed  by  copying  the 
scheme  that  is  used  in  the  demonstration  model  TIME. 

The  user  chooses  equation  specification  and  must  provide  associated  parameters 
for  econometric  work  or  other  sources.  Equation  specification  can  be  linear 
or  nonlinear,  and  variables  can  be  lagged  up  to  9  years.  Equations  in  a  model 
spreadsheet  can  refer  to  other  variables  in  that  spreadsheet  or  other 
spreadsheets.  For  each  model  spreadsheet  requiring  equations,  the  user  must 
code  the  selected  equation  specification  and  parameters  into  the  accompanying 
equation  spreadsheet.  When  this  is  done,  programs  initialize  the  model 
spreadsheets  by  writing  the  equations  and  including  their  calculated  constant 
terms,  which  make  the  equations  replicate  base  period  data. 

Once  the  model  spreadsheets  are  initialized,  the  DWOPSOLV  program  assembles 
all  of  them  in  memory  to  create  a  linked  global  model.  The  user  then  solves 
them  simultaneously  and  saves  the  solution.  Subsequent  scenarios  can  be 
obtained  by  resolving  the  world  model  files  that  were  prepared  by  DWOPSOLV. 
Programs  are  available  to  examine  solution  output  from  various  perspectives. 

The  simple  structure  of  DWOPSIM  models  and  the  fact  that  they  are  built  and 
run  in  spreadsheets  make  it  relatively  easy  for  users  to  prepare  their  own 
methods  of  examining  output  and  doing  post-solution  analysis. 

Key  information  on  model  structure  and  the  location  of  variables  is  found  in 
the  equation  spreadsheets.  The  choice  of  where  to  locate  variables  (which 
columns  of  a  spreadsheet)  is  largely  up  to  the  model  builder.  However,  it  is 
wise  to  be  consistent  across  spreadsheets  in  order  to  simplify  the  preparation 
of  the  three  DWOPSIM  programs  that  must  be  customized  for  each  model. 
Consistency  is  needed  to  simplify  the  preparation  of  the  world  market -clearing 


SWOPSIM 
modeling 
experience,  and 
these  have  evolved 
because  of  the 
need  to  keep 
spreadsheet  base 
models  coded  as 
efficiently  as 
possible . 

If  a  DWOPSIM  user 
can  begin  work 
with  an  existing 
TSView  supply  and 
utilization 
database ,  which 
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mechanism  and  to  take  advantage  of  programs  that  can  manipulate  TSView 
data. 15 

When  the  user  is  familiar  with  DWOPSIM,  the  printouts  of  data  and  equation 
specification  and  parameters  by  the  programs  DWOPBOUT  and  DWOPEOUT ,  will 
provide  adequate  model  recordkeeping. 

The  model  TIME  used  to  illustrate  DWOPSIM  is  a  three-region,  two-product  world 
model  that  includes  features  showing  the  capability  of  DWOPSIM.  These 
features  include  cross-commodity  (and  cross  -  spreadsheet)  equation  linkages, 
lagged  variables  in  equations,  and  various  equation  forms,  including  both 
linear  and  nonlinear  specifications.  The  user  can  view  the  equations  in  the 
TIME  model  equation  spreadsheets. 

DWOPSIM  equations  are  efficiently  written  using  spreadsheet  cell  references, 
but  for  exposition  purposes  they  are  printed  out  by  the  program  DWOPEOUT  using 
variable  names.  The  creation  of  a  DWOPSIM  model  with  more  spreadsheets  than 
found  in  the  demonstration  model  TIME  involves  the  same  principles  illustrated 
with  this  small  model. 

Installation  of  the  DWOPSIM  framework  is  a  simple  matter.  The  disk  containing 
the  programs  includes  instructions  and  an  installation  program.  The  computer 
containing  DWOPSIM  has  to  be  configured  with  a  D:  drive  (use  a  virtual  disk  or 
the  DOS  ASSIGN  command)  and  should  have  4  MB  of  memory  with  software  to  make 
it  usable  by  SuperCalc  5.  The  installation  program  will  create  the  proper 
subdirectories.  If  the  user  has  an  HP  laser  printer,  he  should  also  install 
the  HPLASER  program  on  the  disk  according  to  the  instructions.  This  will  make 
it  possible  to  print  DWOPSIM  output  in  small  print. 

Finally,  experience  with  time  series  model  building  with  DWOPSIM  will  generate 
new  and  better  ways  of  doing  things.  Further  developments  might  include  the 
automatic,  as  opposed  to  manual,  creation  of  model-specific  programs,  such  as 
TIMESOLV.  However,  future  steps  such  as  this  will  depend  upon  experience 
gained  with  DWOPSIM.  In  model  building,  programming  cannot  get  ahead  of 
actual  user  needs.  All  users  are  encouraged  to  record  their  experiences  with 
DWOPSIM  and  provide  suggestions  for  improvement.  In  the  end,  time  series 
modeling  itself  is  the  best  teacher. 


15In  the  case  of  the  model  TIME,  the  three  programs  were  (1)  DWOPTIME 
which  was  needed  to  assemble  commodity  spreadsheet  data  from  TS\ iew  data,  (2) 
TIMESOLV  which  was  needed  by  DWOPSOLV  in  the  world  model  assembly  stage,  and 
(3)  TIMEAGAN  which  can  be  used  for  repeated  solution  scenarios  once  DWOPSOLV 

has  been  run. 
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Appendix  1- -Overview  of  a  TSView  Database  Used  by  DWOPSIM 

The  TSView  system  (2,2)  is  a  database  and  file  viewer  system  developed  by  the 
Economic  Research  Service  (ERS)  to  house  supply  and  utilization  data  for 
grains,  oilseeds,  and  livestock  products.  TSView  also  allows  the  user  to 
select  data  from  a  database  and  put  it  out  in  a  form  that  is  readable  by 
spreadsheets.  This  and  other  capabilities  of  TSView  can  be  automated  with 
utility  programs  that  come  with  the  system.  DWOPSIM  DOS  batch  programs 
combine  these  utilities  with  spreadsheet  macros  and  templates  to  automate  the 
process  of  preparation  of  a  globally  balanced  dataset  for  a  set  of  countries 
in  a  model  for  a  selected  commodity.  The  DWOPSIM  programs  require  that  the 
TSView  database  use  two -letter  country  and  commodity  codes  and  that  the 
programs  themselves  must  be  keyed  to  the  numerical  position  of  a  particular 
country  in  the  TSView  database.  Then  balanced  supply  and  utilization  data  for 
world  models  with  any  mix  of  countries  and  commodities  can  be  easily  created. 

The  TSView  database  behind  this  report  can  be  referred  to  as  the 
DWOPSIM/SWOPSIM  (DS)  TSView  database.  The  key  codes  for  DWOPSIM  users  are  the 
two-letter  code  for  each  country/region  and  two-letter  product  code  for  each 
commodity  (or  aggregate) .  These  codes  are  used  not  only  to  access  the  DS 
database,  but  they  are  also  used  in  DWOPSIM  spreadsheet  names  created  from  the 
data  and,  therefore,  in  variable  names  themselves.  If  the  user  wishes  to  use 
different  codes  and  still  use  the  TSView  database,  the  choice  is  to  re-do  the 
database  or  manually  rename  everything  in  model  spreadsheets  (including 
spreadsheet  names)  derived  from  the  DS  database. 

This  appendix  lists  the  numerical  and  alphabetical  codes  for  all  the 
countries/regions  in  the  FAS  TSView  database  used  by  the  Commodity  Economics 
Division,  ERS,  and  in  the  DS  version  of  the  TSView  database  that  contains 
additional  aggregate  regions  for  the  different  global  databases.  As  a  result, 
there  are  213  countries/regions  in  the  intermediate  version  of  the  CED  TSView 
database,  from  which  we  have  selected  the  following  list  of  143 
countries/regions  for  use  in  the  DS  global  database. 

A  detailed  listing  of  the  countries/regions  within  each  of  the  25  additional 
aggregate  regions  (213  minus  189)  is  provided  by  numerical  codes  here  and  by 
name  in  the  appendix  for  each  global  database  where  they  appear.  The  rest-of - 
world  region  for  each  database  is  provided  by  subtraction.  This  illustrates 
that  the  rest-of -world  region  differs  by  database,  but  does  not  list  exactly 
what  countries/regions  it  contains,  since  it  is  also  used  as  a  trade-balancing 
region.  For  some  SWOPSIM  databases,  the  rest-of -world  region  is  quite  large. 

For  reference,  a  listing  in  numerical  order,  and  by  name,  of  the  189 
countries/regions  contained  within  the  FAS  PS&D  database  follows.  Then 
commodities  included  in  the  DS  database  are  listed.  There  are  47  commodities 
listed  by  name  and  two -letter  alphabetical  code,  which  are  contained  in  the  DS 
version  of  the  TSView  database.  The  first  set  listed  is  the  standard  22- 
commodity  set  used  in  most  ERS  SWOPSIM  models,  and  includes  four  commodities 
that  are  calculated  aggregates.  Next  are  the  seven  additional  commodities 
that  are  now  routinely  included  in  the  SWOPSIM  database  "t"  files,  and  are 
available  in  a  form  ready  for  incorporation  into  models.  Finally,  we  list  the 
18  additional  commodities  available  in  the  DS  TSView  database.  Of  these,  12 
come  from  the  4  aggregate  commodities  in  the  standard  22 -product  (SWOPSIM) 
set,  and  4  come  from  the  4  new  aggregates  that  result  when  the  12  are  removed 
from  the  original  aggregates.  The  last  two  commodities  result  from  the 
poultry  meat  being  separated  into  turkey  meat,  and  broiler  and  other  meat. 
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Concordance  Between  the  FAS  189  Count ry/Reg ion  TSView  Database  and 

DWOPSIM/SWOPSIM  Global  Databases 


Master  Concordance  Between  FAS  PS&D  Database  and  DWOPSIM/SWOPSIM  TSView  Global  Model  Databases 


Number 

DWOPSIM/SWOPSIM 

in  FAS  189 

TSView  Database 

Country  PS&D 

2  Letter  Code  and 

TSView 

Database 

Country/Region  Name 

ORDER 

1 

WD 

- 

WorlD 

1 

2 

FG 

- 

ForeiGn  (non-US) 

2 

6 

US 

- 

United  States 

3 

7 

CN 

- 

Canada 

4 

44 

EC 

- 

European  Community 

5 

58 

WE 

- 

O.W.  Europe 

6 

156 

JP 

- 

Japan 

7 

180 

AU 

- 

Austral ia 

8 

181 

NZ 

- 

New  Zealand 

9 

151 

SF 

- 

South  Africa 

10 

68 

EE 

- 

Eastern  Europe 

11 

67 

S  V 

- 

Soviet  Union 

12 

152 

CH 

- 

P.R.  China 

13 

8 

MX 

- 

Mexico 

14 

190 

CA 

- 

C.  Amer.  &  Caribb. 

15 

31 

AR 

- 

Argentina 

16 

32 

BZ 

- 

Brazi l 

17 

43 

VE 

- 

Venezuela 

18 

199 

LA 

- 

O.  Latin  America 

19 

116 

NG 

- 

Nigeria 

20 

200 

AF 

- 

O.  Sub.S.  Africa 

21 

97 

EG 

- 

Egypt 

22 

191 

MP 

- 

M.E.  &  N.A.  Oil  P. 

23 

192 

MO 

- 

M.E.  &  N.A.  Other 

24 

176 

ND 

- 

India 

25 

201 

OS 

- 

O.  South  Asia 

26 

164 

DO 

- 

I ndones i a 

27 

170 

TH 

- 

Thai  land 

28 

167 

ML 

- 

MaLaysia 

29 

168 

PH 

- 

Phi l ippines 

30 

202 

SA 

- 

0.  S.E.  Asia 

31 

159 

SK 

- 

South  Korea 

32 

160 

TW 

- 

Taiwan 

33 

203 

EA 

- 

O.  East  Asia 

34 

209 

RW 

- 

Rest  of  World  -  WD 

35 

193 

DA 

- 

Dev.  Asian  Imp. 

36 

194 

DE 

- 

Dev.  Exporters 

37 

45 

BL 

- 

Belgium- Lux. 

38 

46 

DN 

- 

DeNmark 

39 

47 

FR 

- 

FRance 

40 

48 

GC 

- 

GreeCe 

41 

49 

IR 

- 

I  Re  land 

42 

50 

IT 

- 

ITaly 

43 

51 

NT 

- 

NeTherlands 

44 

52 

PT 

- 

PorTugal 

45 

53 

SP 

- 

SPain 

46 

54 

UK 

- 

United  Kingdom 

47 

56 

WG 

- 

West  Germany 

48 

57 

GD 

- 

German  Dem.  Rep. 

49 

59 

AT 

- 

AusT  r i a 

50 

61 

FN 

- 

F i N l and 

51 

64 

NO 

- 

NOrway 

52 

65 

SW 

- 

SWeden 

53 

66 

SZ 

- 

Swi tZerland 

54 

195 

ow 

- 

O.  West.  Europe 

55 

69 

AB 

- 

AlBani a 

56 

70 

B I 

- 

Bulgaria 

57 

71 

CZ 

- 

CZeckoslovakia 

58 

72 

HU 

- 

Hungary 

59 

SWOPSIM  2  Digit  Global 
Model  Code  for  Model 
Containing  Country/Region 
WD  =  WorlD,  EU  =  Europe, 

WH  =  Western  Hemisphere, 

AS  =  ASia  and  Pacific  Rim, 
AF  =  AFrica 

(Aggregate) 

(Aggregate) 


WD 

EU 

WH 

AS 

AF 

WD 

EU 

WH 

AS 

Note  that  many 

WD 

WH 

AS 

AF 

of  these  country 

WD 

AS 

TSView  data  sets 

WD 

EU 

WH 

AS 

and  models  are 

WD 

EU 

AS 

used  in  several 

WD 

EU 

AS 

SWOPSIM  global 

WD 

AF 

1989  models. 

WD 

AS 

WD 

EU 

AS 

WD 

AS 

WD 

WH 

AS 

WD 

AS 

WD 

WH 

WD 

WH 

WD 

WH 

WD 

WD 

AF 

WD 

WD  AF 

WD 

WD 

WD  AS 

WD 

WD  AS 

WD  AS 

WD  AS 

WD  AS 

WD 

WD  AS 

WD  AS 

WD 
WD 

EU  (from  SW89,  an  aggregate  of  WD) 

EU  (from  SW89,  an  aggregate  of  WD) 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 

EU 
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189 

S&D 

iase 

73 

74 

75 

92 

95 

204 

210 

10 

11 

12 

13 

14 

15 

16 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

34 

35 

36 

37 

38 

39 

40 

41 

42 

211 

153 

158 

162 

163 

165 

166 

169 

171 

173 

174 

178 

179 

196 

212 

197 

198 

96 

98 

99 

100 

104 

108 

109 

111 

112 

117 

205 

126 


DWOPS I M/SWOPS I M 
TSView  Database 
2  Letter  Code  and 


TSView 


SWOPSIM  2  Digit  Global 
Model  Code  for  Model 
Containing  Country/Region 
WD  =  UorlD,  EU  =  EUrope, 

WH  =  Western  Hemisphere, 

AS  =  ASia  and  Pacific  Rim, 


Country/Region  Name 

ORDER 

AF  =  AFrica 

PL  - 

PoLand 

60 

EU 

RM  - 

RoMania 

61 

EU 

YU  - 

Yugoslavia 

62 

EU 

TK  - 

TurKey 

63 

EU 

NF  - 

North  AFrica 

64 

EU 

OM  - 

O.  Middle  East 

65 

EU 

R1  - 

ROW  for  EU  model 

66 

EU 

BE  - 

BE l i ze 

67 

WH 

CR  - 

Costa  Rica 

68 

WH 

ES  - 

El  Salvador 

69 

WH 

GT  - 

GuaTemala 

70 

WH 

HO  - 

Honduras 

71 

WH 

NI  - 

Nicaragua 

72 

WH 

PA  - 

PAnama 

73 

WH 

BH  - 

BaHamas 

74 

WH 

BA  - 

BArbados 

75 

WH 

BD  - 

BermuDa 

76 

WH 

CU  - 

CUba 

77 

WH 

DR  - 

Dominican  Republic 

78 

WH 

GU  - 

GUada loupe 

79 

WH 

HA  - 

HAiti 

80 

WH 

JM  - 

JaMaica 

81 

WH 

MA  - 

MArtinique 

82 

WH 

NN  - 

Netherlands  ANtil. 

83 

WH 

SC  - 

St.  LuCia 

84 

WH 

ST  - 

ST.  Vincent 

85 

WH 

TT  - 

Trinidad-Tobago 

86 

WH 

BO  - 

BOl ivia 

87 

WH 

CL  - 

ChiLe 

88 

WH 

AS 

CO  - 

Columbia 

89 

WH 

AS 

ED  - 

EcuaDor 

90 

WH 

AS 

GY  - 

GuYana 

91 

WH 

PR  - 

PaRaguay 

92 

WH 

PE  - 

PEru 

93 

WH 

AS 

su  - 

Surinam 

94 

WH 

UR  - 

URuguay 

95 

WH 

R2  - 

ROW  for  WH  model 

96 

WH 

MN  - 

MoNgol ia 

97 

AS 

NK  - 

North  Korea 

98 

AS 

BR  - 

BRunai 

99 

AS 

BU  - 

BUrma 

100 

AS 

KR  - 

Kymer  Republic 

101 

AS 

LO  - 

LaOs 

102 

AS 

SN  - 

SiNgapore 

103 

AS 

VT  - 

V i eT  nam 

104 

AS 

AH  - 

AfgHanistan 

105 

AS 

BG  - 

BanGladesh 

106 

AS 

PK  - 

PaKistan 

107 

AS 

SL  - 

Sri  Lanka 

108 

AS 

OA  - 

Other  Asia 

109 

AS 

R3  - 

ROW  for  ASia  model 

110 

AS 

OE  - 

Other  Europe 

111 

AF 

AS  - 

ASia 

112 

AF 

AL  - 

ALgeria 

113 

AF 

LY  - 

LibYa 

114 

AF 

MC  - 

Morocco 

115 

AF 

TN  - 

TuN i s i a 

116 

AF 

CM  - 

CaMeroon 

117 

AF 

GH  - 

GHana 

118 

AF 

GN  - 

GuiNea 

119 

AF 

IC  - 

Ivory  Coast 

120 

AF 

LB  - 

LiBeria 

121 

AF 

SG  - 

SeneGal 

122 

AF 

AW  - 

O.  West  Africa 

123 

AF 

ZR  - 

ZaiRe 

124 

AF 

CF  - 

Central  AFrica 

125 

AF 
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SWOPSIM  2  Digit  Global 
Model  Code  for  Model 


Number 

DWOPS I  M/SWOPS  I M 

Containing  Country/Region 
WD  =  WorlD,  EU  =  EUrope, 

FAS  189 

TSView  Database 

WH  =  Western  Hemisphere, 

Country  PS&D 

2  Letter  Code  and 

TSView 

AS  =  ASia  and  Pacific  Rim 

Database 

Country/Region  Name 

ORDER 

AF  =  AFrica 

130 

EP  -  Ethiopia 

126 

AF 

131 

KY  -  KenYa 

127 

AF 

133 

SM  -  SoMalia 

128 

AF 

134 

SD  -  SuDan 

129 

AF 

135 

TZ  -  Tanzania 

130 

AF 

136 

UG  -  UGanda 

131 

AF 

207 

AE  -  O.  East  Africa 

132 

AF 

138 

AG  -  AnGola 

133 

AF 

139 

BT  -  BoTswana 

134 

AF 

141 

LH  -  LesotHo 

135 

AF 

142 

MG  -  MadaGascar 

136 

AF 

143 

MW  -  Malawi 

137 

AF 

145 

MZ  -  Mozambique 

138 

AF 

148 

WZ  -  Swaziland 

139 

AF 

149 

ZA  -  ZAmbia 

140 

AF 

150 

ZB  -  ZimBabwe 

141 

AF 

208 

OF  -  O.  Southern  AFrica 

142 

AF 

213 

R4  -  ROW  for  Africa 

143 

AF 

DWOPS I  M/SWOPS  I M 

Aggregate  FAS  PS&D  Country  Code  Numbers 

Region  Code  Included  in  the  Aggregate  Regions 


CA 

9  17 

MP 

77 

79  80 

83 

88  89  90 

91 

93  ' 

96  98  100 

MO 

78 

81  82 

84 

85  92  99 

CP 

67 

68  152 

DA 

155 

157 

158 

159 

160 

DE 

31 

32  164  167  168  170 

OW 

60 

62  63 

OA 

155 

157 

175 

177 

182 

183 

184 

185 

186 

187 

188 

189 

OE 

58 

67  68 

AS 

152 

153 

154 

161 

172 

LA 

34 

35  36 

37 

38  39  40 

41 

42 

AF 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

119 

120 

127 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

OS 

173 

174 

175 

177 

178 

179 

182 

183 

184 

185 

186 

187 

188 

189 

SA 

162 

163 

165 

166 

169 

171 

EA 

155 

157 

158 

OM 

77 

78  79 

80 

81  82  83 

84 

85  I 

38  85 

>  90 

91  93 

AW 

102 

103 

105 

106 

107 

110 

113 

114 

115 

118 

119 

CF 

121 

122 

123 

124 

125 

AE 

128 

129 

132 

OF 

140 

144 

146 

147 

117  118 
149  150 


DWOPS I M 

/SWOPSIM  FAS  PS&D  Country  Code  Numbers 

ROW  Code  Subtracted  from  the  World  Total  (the  first  code  which  is  1) 

RW  6  7  8  31  32  43  44  58  67  68  97  116  151  152  156  159  160  164  167  168  170  176  180  181  190  191 

192  199  200  201  202  203 

R1  6  7  45  46  47  48  49  50  51  52  53  54  56  57  59  61  64  65  66  67  69  70  71  72  73  74  75  92  95  156 
180  181  193  194  195  204 

R2  6  7  8  10  11  12  13  14  15  16  18  19  20  21  22  23  24  25  26  28  29  30  31  32  34  35  36  37  38  39 
40  41  42  43  44  156 

R3  6  7  8  35  36  37  40  44  58  67  68  152  153  156  158  159  160  162  163  164  165  166  167  168  169  170 
171  173  174  176  178  179  180  181  190  196 

R4  6  44  96  97  98  99  100  104  108  109  111  112  116  117  126  130  131  133  134  135  136  138  139  141 
142  143  145  148  149  150  151  197  198  205  206  207  208 


The  program  TSSWOP  calculates  values  for  the  ROW  (Rest-Of -World)  region  of  each  world  model  by 
subtracting  values  for  each  FAS  country  from  the  FAS  world  value  (FAS  code  =  1).  The  subtraction 
is  done  with  a  TSVIEW  utility  controlled  by  a  DOS  batch  program.  If  the  TS  data  files  are 
updated,  TSSWOP  can  be  run  again  to  recalculate  the  SWOPSIM  intermediate  database  values. 
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FAS  Database 

FAS  PS&D  Country 

FAS  Database  FAS  PS&D  Country 

Count ry/Regi on 

Number  Code 

Country/Region 

Number  Code 

WORLD 

1 

POLAND 

73 

FOREIGN 

2 

ROMANIA 

74 

CENTRALLY  PLANNED 

3 

YUGOSLAVIA 

75 

NICs 

4 

MIDDLE  EAST 

76 

LESS  DEVELOPED 

5 

These  are  the 

BAHRAIN 

77 

UNITED  STATES 

6 

countries  and 

CYPRUS 

78 

CANADA 

7 

regions  in  the 

IRAN 

79 

MEXICO 

8 

189  country/ 

IRAQ 

80 

CENTRAL  AMERICA 

9 

region  FAS  PS&D 

ISRAEL 

81 

BELIZE 

10 

database  kept  in 

JORDAN 

82 

COSTA  RICA 

11 

the  TSView  data 

KUWAIT 

83 

EL  SALVADOR 

12 

system.  The 

LEBANON 

84 

GUATEMALA 

13 

numerical  codes 

UNITED  YEMEN 

85 

HONDURAS 

14 

are  to  the  right 

NORTH  YEMEN-SANA 

86 

NICARAGUA 

15 

of  the  country/ 

SOUTH  YEMEN-ADEN 

87 

PANAMA 

16 

region  names. 

OMAN 

88 

CARIBBEAN 

17 

QATAR 

89 

BAHAMAS 

18 

SAUDI  ARABIA 

80 

BARBADOS 

19 

SYRIA 

91 

BERMUDA 

20 

TURKEY 

92 

CUBA 

21 

UNITED  ARAB  EMIRATES 

93 

DOMINICAN  REPUBLIC 

22 

SUBSAHARAN  AFRICA 

94 

GUADELOUPE 

23 

NORTH  AFRICA 

95 

HAITI 

24 

ALGERIA 

96 

JAMAICA 

25 

EGYPT 

97 

MARTINIQUE 

26 

LIBYA 

98 

NETHERLAND  ANTILLES 

27 

MOROCCO 

99 

ST  LUCIA 

28 

TUNISIA 

100 

ST  VINCENT 

29 

WEST  AFRICA 

101 

TRINIDAD-TOBAGO 

30 

BENIN 

102 

ARGENTINA 

31 

BURKINA 

103 

BRAZIL 

32 

CAMEROON 

104 

OTHER  SOUTH  AMERICA 

33 

CAPE  VERDE 

105 

BOLIVIA 

34 

CHAD 

106 

CHILE 

35 

GAMBIA 

107 

COLOMBIA 

36 

GHANA 

108 

ECUADOR 

37 

GUINEA 

109 

GUYANA 

38 

GUINEA-BISSAU 

110 

PARAGUAY 

39 

IVORY  COAST 

111 

PERU 

40 

LIBERIA 

112 

SURINAM 

41 

MALI 

113 

URUGUAY 

42 

MAURITANIA 

114 

VENEZUELA 

43 

NIGER 

115 

EC-12 

44 

NIGERIA 

116 

BELGIUM-LUX 

45 

SENEGAL 

117 

DENMARK 

46 

SIERRE  LEONE 

118 

FRANCE 

47 

TOGO 

119 

GREECE 

48 

CENTRAL  AFRICA 

120 

IRELAND 

49 

CENTRAL  AFRICAN  REPUBLIC 

121 

ITALY 

50 

CONGO 

122 

NETHERLANDS 

51 

EQUATORIAL  GUINEA 

123 

PORTUGAL 

52 

GABON 

124 

SPAIN 

53 

SAO  TOME  &  PRINCIPE 

125 

UK 

54 

ZAIRE 

126 

UNITED  GERMANY 

55 

EAST  AFRICA 

127 

WEST  GERMANY 

56 

BURUNDI 

128 

EAST  GERMANY 

57 

DJIBOUTI 

129 

OTHER  WESTERN  EUROPE 

58 

ETHIOPIA 

130 

AUSTRIA 

59 

KENYA 

131 

FAEROE  ISLANDS 

60 

RWANDA 

132 

FINLAND 

61 

SOMALIA 

133 

ICELAND 

62 

SUDAN 

134 

MALTA 

63 

TANZANIA 

135 

NORWAY 

64 

UGANDA 

136 

SWEDEN 

65 

SOUTHERN  AFRICA 

137 

SWITZERLAND 

66 

ANGOLA 

138 

SOVIET  UNION 

67 

BOTSWANA 

139 

EASTERN  EUROPE 

68 

COMORO  ISLANDS 

140 

ALBANIA 

69 

LESOTHO 

141 

BULGARIA 

70 

MADAGASCAR 

142 

CZECHOSLOVAKIA 

71 

MALAWI 

143 

HUNGARY 

72 

MAURITIUS 

144 
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FAS  Database 

FAS  PS&D  Country 

FAS  Database 

FAS  PS&D  Country 

Country/Region 

Number  Code 

Country/Region 

Number  Code 

MOZAMBIQUE 

145 

PHILIPPINES 

168 

REUNION 

146 

SINGAPORE 

169 

SEYCHELLES 

147 

THAILAND 

170 

SWAZILAND 

148 

VIETNAM 

171 

ZAMBIA 

149 

SOUTH  ASIA 

172 

ZIMBABWE 

150 

AFGHANISTAN 

173 

REPUBLIC  OF  SOUTH 

AFRICA  151 

BANGLADESH 

174 

CHINA 

152 

BHUTAN 

175 

OUTER  MONGOLIA 

153 

INDIA 

176 

EAST  ASIA 

154 

NEPAL 

177 

HONG  KONG 

155 

PAKISTAN 

178 

JAPAN 

156 

SRI  LANKA 

179 

MACAO 

157 

AUSTRALIA 

180 

NORTH  KOREA 

158 

NEW  ZEALAND 

181 

SOUTH  KOREA 

159 

PAPUA  NEW  GUINEA 

182 

TAIWAN 

160 

FIGI 

183 

SOUTHEAST  ASIA 

161 

WEST  SAMOA 

184 

BRUNEI 

162 

NEW  CALEDONIA 

185 

BURMA 

163 

TONGA 

186 

INDONESIA 

164 

BRITISH  SOLOMON 

ISLANDS  187 

KHMER  REPUBLIC 

165 

GILBERT  &  ELLICE 

ISLANDS  188 

LAOS 

166 

NEW  HEBRIDES 

189 

MALAYSIA 

167 

Commodi ty 

in  FAS  189  Product/Product  Group 

Country  PS&D  Contained  in  TSView 

Database  DWOPSIM/SWOPSIM  Database 


*  DWOPSIM/SWOPSIM  Product 
Group  Calculated 
from  FAS  PS&D 
Commodities: 


BEEFVEAL 

BF 

- 

BeeF  and  veal 

1 

PORK 

PK 

- 

PorK 

2 

LAMBMUTT 

ML 

- 

Mutton  and  Lamb 

3 

TOTPLTRY 

PM 

- 

Poultry  Meat 

4 

EGGS 

PE 

- 

Poultry  Eggs 

5 

FLUIDMLK 

DM 

- 

Dairy  -  fresh  Milk 

6 

BUTTER 

DB 

- 

Dairy  -  Butter 

7 

CHEESE 

DC 

- 

Dairy  -  Cheese 

8 

NFDMILK 

DP 

- 

Dairy  -  Powder 

9 

WHEAT 

WH 

- 

WHeat 

10 

CORN 

CN 

- 

CorN 

11 

-  =  Standard 

*  Calc. 

CG 

- 

other  Coarse  Grains 

12  COARSEGR-CORN 

22  Product 

RICE 

R I 

- 

Rice 

13 

Model 

SOYBEANS 

SB 

- 

SoyBeans 

14 

SOYMEAL 

SM 

- 

SoyMeal 

15 

SOYOIL 

SO 

- 

SoyOi l 

16 

*  Calc. 

OS 

- 

Other  oilseeds 

17  TOTSEEDS-SOYBEANS 

*  Calc. 

OM 

- 

Other  Meals 

18  TOTMEALS-SOYMEAL 

*  Calc. 

00 

- 

Other  Oi Is 

19  TOTOI LS-SOYOI L 

COTTON 

CT 

- 

CoT  ton 

20 

SUGAR 

SU 

- 

SUgar 

21 

TOBUNMFG 

TB 

- 

ToBacco 

22 

DRYBEANS 

BN 

- 

dry  BeaNs 

23  j 

COFFEE 

CF 

- 

green  CoFfee 

24 

=  Other  Products 

HIDESKIN 

HS 

- 

Hides  and  Skins 

25 

in  TSView  SWOPS I M 

CATTLEIN 

Cl 

- 

Cattle  INventory 

26 

Database 

SWINEINV 

PI 

- 

Pig  Inventory 

28 

SHEEPINV 

SI 

- 

Sheep  Inventory 

28 

TALLOWGR 

TG 

• 

Tallow  and  Grease 

29 

SORGHUM 

SG 

- 

SorGhum 

30 

1 

BARLEY 

BY 

- 

BarleY 

31 

1  “ 

•Subset  of 

OATS 

OT 

- 

OaTs 

32 

1 

i 

standard 

*  Calc 

OC 

- 

Other  Coarse  grains 

33  COARSEGR-CORN-SORGHUM-OATS 

j 

22  product 

RAPESEED 

RS 

- 

RapeSeed 

34 

1 

1 

Model 

SUNSEED 

US 

- 

sunflower  Seed 

35 

■ 

PEANUTS 

NS 

- 

peaNutS 

36 

1 

1 

*  Calc 

TS 

- 

oTher  oilseeds 

37  TOTSEEDS-SOYBEANS-RAPESEED-SUNSEED-PEANUTS 
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Commodi ty 

*  DWOPSIM/SWOPSIM  Product 

in  FAS  189 

Product/Product  Group 

Group  Calculated 

Country  PS&D 

Contained  in  TSView 

from  FAS  PS&D 

Database 

DWOPSIM/SWOPSIM  Database 

Commodities: 

RAPEMEAL 

RM  - 

Rapeseed  Meal 

38 

i 

SUNMEAL 

UM  - 

sunflower  seed  Meal 

39 

PNUTMEAL 

NM  - 

peaNut  Meal 

40 

--Subset  of 

*  Calc 

TM  - 

oTher  Meals 

41 

TOTMEALS-SOYMEAL- RAPEMEAL -SUNMEAL -PNUTMEAL 

standard 

RAPEOIL 

RO  - 

Rapeseed  Oi l 

42 

22  product 

SUNOI L 

UO  - 

sunflower  seed  Oil 

43 

Model 

PNUTOIL 

NO  - 

peaNut  Oi l 

44 

*  Calc 

TO  - 

oTher  Oi Is 

45 

TOTOI LS-SOYOI L-RAPEOI L- SUNOI L-PNUTOI L 

TURKEY 

TK  - 

Turkey  meat 

46 

*  Calc 

BM  - 

Broilers  and  other  meat 

47 

TOTPLTRY- TURKEY 
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Appendix  2 - -Documentation  of  the  DWOPSIM  Demonstration  Model  TIME 


This  appendix  gives  sample  documentation  for  one  model  spreadsheet  in  TIME 
(USBF) .  The  user  can  use  DWOPSIM  programs  to  print  other  spreadsheets  (see 
fig.  1,  page  2,  which  shows  the  spreadsheet  structure  of  TIME).  Documentation 
of  the  data  in  a  model  spreadsheet  is  printed  out  (or  printed  to  disk)  by  the 
program  DWOPBOUT.  If  a  model  spreadsheet  contains  equations,  the  program 
DWOPEOUT  will  print  documentation  of  the  equations.1 

Data  documentation:  The  data  in  TIME  are  history  for  1960-91  and  projected  to 
2020.  Although  the  model  spreadsheets  actually  contain  projected  data  up  to 
2020,  DWOPBOUT  prints  data  from  1960  to  2005.  The  structure  of  the  model 
spreadsheets  is  part  of  the  model  design,  and  it  is  a  matter  of  judgment  of 
how  large  a  spreadsheet  is  needed.  The  user  can  obtain  full  printouts  of  the 
model  spreadsheets  by  using  normal  spreadsheet  printing  techniques. 

Equation  documentation:  Documentation  of  the  equations  coded  in  the  equation 
spreadsheet  is  the  standard  output  of  the  DWOPEOUT  program.  DWOPEOUT  produces 
three  pages  for  each  model  equation  spreadsheet.  The  first  two  pages  are  a 
matrix  of  cells  in  the  spreadsheet.  The  rows  contain  information  about  terms 
in  an  equation;  the  name  of  the  variable  explained  is  on  the  left  along  with 
the  letter  of  its  home  column  in  the  model  spreadsheet.  Some  rows  have  no 
names  and  no  information  in  cells — these  are  just  extra  rows  that  might 
contain  equation  information  in  more  complex  models.  The  columns  in  the  model 
equation  spreadsheet  represent  the  explanatory  variables  in  the  equations.  If 
there  is  no  variable  name  under  a  column,  there  is  no  explanatory  variable  in 
that  column  in  the  spreadsheet.  If  cells  under  a  variable  name  are  empty, 
that  means  that  the  column  variable  is  not  used  in  an  equation  represented  by 
the  cell  row.  When  a  cell  has  contents,  notation  in  the  cell  gives  the 
mathematical  representation  of  how  the  column  variable  (represented  by  the 
"v")  is  included  in  the  equation  represented  by  the  row.  Parameters  are  also 
included  in  cells.  For  example,  in  many  of  the  TIME  model  cells,  one  will  see 
elasticities  or  other  parameters  as  part  of  the  cell  notation.  The  bottom 
half  of  the  second  page  (right  side)  gives  some  notes  explaining  the 
nomenclature  used  for  variables  in  the  model  TIME. 

The  third  page  of  the  equation  documentation  gives  a  "readable"  version  of  the 
equations  themselves.2  The  top  part  of  the  page  gives  the  variable  codes  and 
their  descriptions,  units,  and  home  spreadsheet  column.  The  bottom  half  of 
the  page  gives  the  equations  themselves  written  using  DWOPSIM  variable 
nomenclature  from  the  model  TIME.  The  spacing  of  the  variables  and  equations 
follows  their  row  position  in  the  equation  spreadsheet.  Variables  explained 
by  equations  are  marked  by  an  "X" .  Other  variables  will  be  exogenous 
variables,  formula  driven  identities,  or  variables  from  other  spreadsheets. 


1Note  that  in  printout  of  data  from  the  model  spreadsheets,  cells  of 
columns  containing  no  data  are  marked  by  dots  " . "  A  more  complex  model  could 
add  variables  in  these  columns.  "N/A"s  mark  cells  where  data  are  "not 
available"  for  particular  years.  In  the  model  TIME,  this  is  the  case  with 
support  information  which  exists  for  a  shorter  period  than  quantity  data. 

2This  is  useful  because  the  equations  in  spreadsheet  cells  use  only  cell 
notation  to  designate  variables.  This  is  efficient  for  computation  but  makes 
it  difficult  to  read  the  equations.  This  third  page  of  the  DWOPEOUT  printout 
provides  a  "readable"  version  of  equations  for  the  convenience  of  the  user. 
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Col.> 

USBF 

Uhit 

SSWC 

Year.. 

B  C  D  E 

SLa  Slang  PRodncti  IFtoorts  E 

rurber  KG/an  1000  MT  1000  MT  1 

BFrtSL  BFrSW  BFcfR  BFqlM 

F  G  H 

Xports  CoNsuipt  End. S toe 
000  MT  1000  MT  1000  MT 
BFcfEX  BFqCN  BFcfS 

1960 

34644  .2076839 

7195 

352 

4 

7543 

83 

34551  .2149287 

7426 

470 

15 

7868 

96 

34768  .2069432 

7195 

352 

16 

7535 

92 

35274  .2105233 

7426 

470 

16 

7842 

130 

39310  .1885271 

7411 

653 

15 

8030 

149 

1965 

40959  .2186821 

8957 

427 

24 

9387 

122 

41036  .2280924 

9360 

546 

18 

9866 

144 

40407  .2358750 

9531 

602 

19 

10128 

130 

41034  .2389238 

9804 

689 

17 

10460 

137 

40584  .2439878 

9902 

744 

15 

10603 

165 

1970 

39559  .2553907 

10103 

824 

18 

10917 

157 

39730  .  2563302 

10184 

797 

24 

10944 

170 

39335  .2637346 

10374 

905 

28 

11249 

172 

36506  .2686682 

9808 

917 

41 

10647 

209 

40528  .2643851 

10715 

747 

29 

11453 

189 

1975 

46870  .2404737 

11271 

808 

24 

12080 

164 

48726  .  2496819 

12166 

950 

41 

13024 

215 

48073  .  2463753 

11844 

890 

47 

12754 

148 

44272  .2547660 

11279 

1053 

74 

12160 

246 

36052  .2687101 

9924 

1103 

78 

10982 

213 

1980 

36795  .2717217 

9998 

946 

80 

10877 

200 

38151  .2713952 

10354 

799 

100 

11097 

156 

39264  .2655104 

10425 

889 

115 

11176 

179 

40136  .2677895 

10748 

873 

125 

11476 

199 

41259  .2648877 

10929 

838 

152 

11594 

220 

1985 

40048  .2745955 

10997 

948 

151 

11819 

195 

41046  .2751060 

11292 

978 

239 

12036 

190 

38792  .2805733 

10884 

1040 

2  77 

11660 

177 

37889  .2871546 

10880 

1091 

313 

11641 

194 

36329  .2926863 

10633 

988 

464 

11197 

154 

1990 

35245  .  2960215 

10465 

1068 

456 

11048 

183 

Row 

1 

2 

3 

TIf€ 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

Row 

1 

2 

3 

TIME 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


35650.00 
.  35831.48 
.  36106.92 
36309.12 
1995  36512.41 
36716.84 
.  36020.13 
.  37124.05 
37326.49 
2000  37529.97 
37732.10 
.  37935.22 
.  38139.35 
38341.93 
2005  38545.47 


Col.> 

USBF 

Unit 

SSWC 

Year. 

1960 


145.0000 

145.7381 

146.8585 


,2960144  10585.00  1030.000  472.0000  11181.00 

.2960144  10638.88  1046.383  474.4028  11358.84 

.2960144  10720.67  1062.706  478.0496  11536.04 

,2960144  10780.70  1078.970  480.7267  11712.59  147.6809 

.2960144  10841.06  1095.173  483.4182  11888.48  148.5077 

,2960144  10901.76  1110.946  486.1247  12059.70  149.3392 

,2960144  10962.12  1126.921  488.8163  12Z33.11  150.1660 

.2960144  11022.67  1143.081  491.5161  12408.54  150.9954 

.2960144  11082.78  1159.429  494.1965  12586.00  151.8188 

.2960144  11143.19  1175.966  496.8905  12765.52  152.6464 

.2960144  11203.21  1197.313  499.5667  12997.24  153.4686 

.2960144  11263.51  1219.039  502.2559  13233.08  154.2947 

.2960144  11324.12  1241.150  504.9586  13475.10  155.1250 

.2960144  11384.27  1263.652  507.6407  13717.37  155.9489 

,2960144  11444.71  1286.551  510.3355  13965.95  156.7768 


P 

Q 

RSTUVWXYZAA 
BF-PI.pr  BF-CI.pr  Net  Trad  P.S.wedg  C.S.wedg  E.S.wecjg  I.S.wedg  PRod.shf  CcNs.shf 

89.USVM  89.USS/M  1000  MT  89.US$/M  89.USS/M  89.USS/M  89.USS/M  Percent  Nuiber 

BFpPI  BFpCI  BFcjjT  BFtPS  BFwCS  BFk£S  BFwIS  BFfPR  BFfCN 

AB 

AC 

N/A 

N/A 

-348 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-455 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-336 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-454 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-638 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-403 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-528 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-583 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-672 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-729 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-806 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-773 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-877 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-876 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-718 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-784 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-909 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-843 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-979 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-1025 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-866 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-609 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-774 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-748 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-686 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-797 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-739 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-763 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

-778 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

2636 

4779 

-524 

N/A 

14 

N/A 

-44 

N/A 

N/A 

.  2559.2Z3  4639.806 

-612 

N/A  13.59223 

N/A  - 

42.7184 

N/A 

N/A 

.  2555.249  4575.232  - 

558.000 

0  13.19634 

0  - 

41 .4742 

0 

0 

.  2525.541  4545.908  - 

720.604 

0  12.81196 

0  - 

4U.2662 

0 

0 

.  2496.068  4516.808  - 

816.491 

0  12.43882 

0  - 

39.0934 

0 

0 

.  2466.829  4487.932  - 

932.705 

0  12.07652 

0  - 

37.9548 

0 

0 

.  2437.824  4459.278  - 

1048.24 

0  11.72478 

0  - 

36.04V3 

0 

0 

.  2409.050  4430.846  - 

1158.77 

0  11.38328 

0  - 

35.7760 

0 

0 

.  2380. 408  4402.536  - 

1271.82 

0  11.05173 

0  - 

34.7340 

0 

0 

.  2351.997  4374.446  - 

1386.70 

0  10.72983 

0  - 

33. 6223 

0 

0 

.  2323.814  4346.576  - 

1504.05 

0  10.41731 

0  - 

32.7401 

0 

0 

.  2295.861  4318.926  - 

1623.15 

0  10.11390 

0  - 

31.7865 

0 

0 

.  2268.135  4291.495  - 

1794.86 

0  9.819318 

0  - 

30.8607 

0 

0 

.  2240.636  4264.282  - 

1970.40 

0  9.533319 

0  - 

29.9619 

0 

0 

.  2213.363  4237.287  - 

2149.81 

0  9.255649 

0  - 

29.0892 

0 

0 

.  2186.316  4210.510  - 

2333.92 

0  8.986067 

0  - 

28.2419 

0 

0 

.  2159.494  4183.949  - 

2522.07 

0  8.724337 

0  - 

27.4193 

0 

0 

1965 


1970 


1975 


I960 


1985 


1990 


1995 


2000 


2005 
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US8FEQ  Slaughter  Slau^it.Ut.  PRocLction  IMports  Exports  CoNsurpticn  End. Stocks 

Base  row>  36  nurber  KG/aiimal  1000  MT  1000  MT  1000  MT  1000  MT  1000  MT 

Variable-(SSvVC)->  USBFnSL  USBFrSW  USBFcfR  USBFqlM  USBFcfX  USBFqCN  USBFcfS 

Variable  colum-->  B  C  D  E  F  G  H 

BFnSL  B 

BFrSW  C 

*v 

*v 

(1/v) 

BFcfR  D 

BFqlM  E 

BFcfX  F 

BFqCN  G 

BFcfS  H 

BFpPI  S 

BFpPIl  S 

BFpPl2  S 

BFpCI  T 

BFcfJT  U 

BFwPS  V 

BFwCS  W 

BFwES  X 

BFwIS  Y 

BFePF  Z 

BFfCF  AA 

*v 

*v 

*v 

US8FEQ 

Base  row>  36 
Variable-(SSvVC)-> 
Variable  colum--> 


BF-PI .price  BF-PI .price  BF-PI .price  BF-CI. price  Net  Trade 
89.US$/MT  89.US$/MT  8P.US$/MT  89.USS/MT  1000  MT 

USBFpPI  USBFpPIl  USBFpPl2  USBFpCI  US8F<^T 
S  S  S  T  U 


BFnSL  B 
BFrSW  C 
BFcpR  D 
BFqlM  E 
BF<£X  F 
BFqCN  G 
BFqES  H 


BFpPI  S 
BFpPIl  S 
BFpPl2  S 
BFpCI  T 
BFcfJT  U 
BFwPS  V 
BFwCS  U 
BFv£S  X 
BFwIS  Y 
BFePF  Z 
BFfCF  AA 
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US8FEQ 

Base  row>  36 
Variable-(SSvVC)-> 
Variable  colum--> 


P.S. wedge 

C.S. wedge 

E.S. wedge 

I. S. wedge 

Prod.shFt. 

Cons.shFt. 

89.US$/MT 

89.US$/MT 

a9.US$/MT 

89.US$/MT 

Nurber 

Nurber 

USBFtPS 

USBFwCS 

US8Fv£S 

US8FWIS 

US8FePF 

USBFfCF 

V 

W 

X 

Y 

Z 

AA 

*(1+v) 

*(1+v> 

-v 

-v 

BFnSL  B 
BFrSW  C 
BFcfR 
BFqlM 
BFcfX 
BFqCN 


BFcfS  H 


BFpPI  S 
BFpPIl  S 
BFpPl2  S 
BFpCI  T 
BFcfT  U 
BFtPS  V 
BFwCS  W 
BFi£S  X 
BFwIS  Y 
BFePF  Z 
BFfCF  AA 


US8FEQ 

Base  row>  36 

CN-CN. price 

89.US$/MT 

U)  Ref.P. 
89.US$/MT 
W)pRP 
C 

TiMe  trend  real  INcane 
cant  M.89.USS 

Population 

1000s 

USePP 

C 

Model  =  TIME 

Variable-(SSvVC)-> 
Variable  colum--> 

USCNpCN 

T 

V4^ein 

B 

B 

Variable  names  have 

BFnSL  B 

form:  SSvVC  vJnere: 

BFrSW  C 

SS  =  Spreadsheet  for 

BFcfR  D 

BFqlM  E 

BFcfX  F 

BFqCN  G 

BFcfS  H 

V-.05 

*O+.0116rv 

country  &  product, 

country/ region, 

*V\16 

*\T(1-.16) 

or  world  (prices): 

v  =  Variable  type: 

a  -  Area 

n  -  Nurber 

q  -  Quantity, 

r  -  Ratio 
p  -  Price, 
w  -  price  Wedge 
f  -  shiFt  percent 
l  -  vaLue 

BFpPI  S 

BFpPIl  S 

BFpPI 2  S 

BFpCI  T 

BFcfT  U 

BFfcPS  V 

+v 

VC#  =  Variable 

name  Code  and 
#  =  var.  lag: 

BFwCS  W 

HV  -  area  Harvested 
PR  -  PRoduction 

BFwES  X 

BFwIS  Y 

BFePF  Z 

IM  -  IFports 

EX  -  Exports 

NT  -  Net  Trade 

CN  -  CcNsurption 

ES  -  Ending  Stocks 

FD  -  FeeD  consurp. 

OC  -  Other  Consurp. 
PI  -  Producer 

Incentive  price 

BFfCF  AA 

Cl  -  Consuner 

Incentive  price 
RF  -  Reference  Price 

IN  *  I Neeme 

PP  -  Population 

TM  -  TiMe 
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Model  =  TIME 


Variables  and  Equations  in  spreadsheet- ->  USBF 
Variable  Eq.(x)  Variable  description  (init),  spreadsheet  colum 


USBFrtSL 

USBFrSW 

USBFcfR 

USBFqlM 

US8FcfX 

USBFqCN 

US8FcJES 


x  Slaughter  (nuiber),  col.  B 

x  Slaqght.Wt.  (KG/animal),  col.  C 

x  PRoduction  (1000  MT),  col.  D 
x  I^oorts  (1000  MT),  col.  E 

X  Exports  (1000  MT),  col.  F 

x  CoNsuipticn  (1000  MT),  col.  G 

x  End. Stocks  (1000  MT),  col.  H 


USBFpPI 

USBFpPIl 

US8FpPl2 

USBFpCI 

USBFcfT 

USBFwPS 

USBFwCS 

USBFtfS 

USBFwIS 

USBFePF 

USBFfCF 


x  BF-PI. price  (89.US$/MT),  col.  S 

BF-PI .price  (89.USS/MT),  col.  S 
BF-PI .price  (89.US$/MT),  col.  S 
x  BF-CI. price  (89.US$/MT),  col.  T 

Net  Trade  (1000  MT),  col.  U 
P.S. wedge  (89.USS/MT),  col.  V 
C.S. wedge  (89.US$/MT),  col.  U 
E.S. wedge  (89.US$/MT),  col.  X 
I. S. wedge  (89.US$/MT),  col.  Y 
Prod.shFt.  (Nuiber),  col.  Z 
Cons.shFt.  (Nuiber),  col.  AA 


USCNpCN 


CN-CN. price  (8P.US$/MT),  col.  T 


WDpRP 

W)eTM 

USeIN 

USePP 


U)  Ref .P.  (89.US$/MT),  col.  C 
TiMe  trend  (cant),  col.  B 
real  INcotb  (M.89.US$),  col.  B 
Population  (1000s),  col.  C 


Var.  Equation, 


USBFrSL  =  Constant*USBFcpR 

USBFrSW  =  Constant+(1/US8FnSL)*USBFcpR 

USBFcfR  =  Ccrstant*USBFpPIA.1*USBFpPI1A.3*USBFpPl2A.2*(1-HJSBFePF)*USCNpOr-.05*(1+.0116)AVDeTM 
USBFqlM  =  Constant*USBFqCN 
USBFcfX  =  Constant*USBFcfR 

USBFqCN  =  Constant*USBFpCIA-.7*(1-KJSBFfCF)*USeINA.16*USePPA(1-.16) 

USBFcfS  =  Constant*USBFcfR 


US8FpPI  =  Ccnstant+-USBFwI  SHJDpRP 
USBFpCI  =  ConstantHJSBFpPI  -USBFwCS 
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Appendix  3 --Annotated  Listings  of  DWOPSIM  Computer  Programs 

DWOPSIM  computer  programs  and  routines  are  relatively  simple.  When  tasks 
require  spreadsheet  formats  or  data  manipulations,  spreadsheet  templates  are 
created.  The  C:\DWOPSIM  subdirectory  contains  several  spreadsheet  templates, 
which  are  called  and  used  by  DOS  batch  programs ,  usually  with  the  same  name  as 
the  spreadsheet.  Some  spreadsheets  are  complex  such  as  the  one  that  actually 
writes  DWOPSIM  equations.  But  all  programming,  whether  in  DOS  batch  programs 
or  in  spreadsheets,  is  open  to  the  user. 

DOS  batch  programs  control  DWOPSIM  operations  and  write  spreadsheet  macros. 

The  listings  that  follow  are  the  key  DOS  batch  programs  that  make  up  DWOPSIM. 
In  some  cases,  annotation  has  been  added  to  the  documentation  already 
contained  in  the  programs.  The  name  of  each  batch  program  is  highlighted  in 
bold  print.  Almost  all  DWOPSIM  DOS  batch  programs  have  explanatory  screens. 

If  the  user  does  not  know  what  a  batch  program  does  or  what  parameters  it 
requires,  typing  the  name  of  the  program  will  bring  up  the  explanatory  screen. 
In  the  following  pages,  the  material  in  the  explanatory  screens  will  be  seen 
at  the  beginning  of  the  batch  programs,  produced  by  ECHO  commands  on  the  left. 

Most  DWOPSIM  programs  apply  to  all  models;  the  first  four  characters  of  their 
names  are  DWOP.  However,  three  important  DOS  batch  programs  must  be  created 
for  each  model.  For  the  model  TIME,  they  have  the  names  DWOPTIME,  TIMESOLVE, 
and  TIMEAGAN.  These  programs  can  be  created  for  a  new  model  by  selective  text 
editing  of  the  programs  associated  with  the  model  TIME.  Certain  parts  of  the 
batch  programs  and/or  associated  spreadsheets  must  conform  with  product  and 
country  codes  in  a  new  model.  And  lines  must  be  added  if  the  new  model  has 
more  countries  or  commodities  than  the  model  TIME.  The  creation  of  these 
three  "customized"  batch  program  defines  a  new  model  much  in  the  way  that  a 
new  master  model  file  defined  a  new  model  in  SWOPSIM. 

The  first  program  to  be  created  (DWOPTIME  for  the  model  TIME)  tells  DWOPSIM 
what  country  data  to  get  from  the  TSView  database  for  the  world  model.  It 
also  defines  the  rest-of-world  region  as  the  world  minus  the  countries/regions 
explicitly  defined  in  the  model.  When  this  program  is  run,  the  user  gets  a 
globally  balanced  set  of  commodity  data  for  the  commodity  selected.  Balanced 
means  that  rest-of-world  data  from  the  TSView  database  are  adjusted  so  that 
world  supply  equals  world  demand,  world  net  trade  equals  zero,  and  world 
imports  equal  world  exports  for  every  year  in  the  historical  data.  The 
"balancing"  rule  is  contained  in  a  spreadsheet  template  DWOPBLRW. CAL.  This 
spreadsheet  has  to  be  consistent  with  the  data  modeled.  For  example,  in  the 
model  TIME,  data  include  stock  changes  and,  therefore,  world  balances  must 
account  for  stock  changes.  The  second  program  to  be  created  (TIMESOLV)  tells 
DWOPSIM  what  commodity  spreadsheets  need  to  be  collected  into  memory  to  form  a 
world  model.  The  program  is  called  by  the  generalized  DWOPSOLV  program.  The 
third  program  is  TIMEAGAN,  which  allows  repeated  scenario  analysis  once 
DWOPSOLV  has  been  run. 

All  of  the  programs  have  error  traps  that  stop  the  program  and  tell  the  user 
if  some  important  spreadsheet  or  program  or  piece  of  entry  information  is 
missing.  When  a  program  successfully  completes  its  task,  the  results  are  left 
on  the  D:  drive.  The  user  can  inspect  them,  and  if  they  are  satisfactory, 
they  must  be  manually  saved  to  the  model  file.  This  feature,  similar  to  that 
used  in  SWOPSIM,  insures  that  programs  producing  errors  will  not  destroy  model 
information.  But  the  user  is  advised  always  to  have  backup  copies  of  model 
files  available  just  in  case  mistakes  are  made. 
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ECHO  DWOPTIME  Program  to  make  a  complete  set  of  balanced  supply  and 
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Reports  you  can  use  . . .  from  ERS 


U.S.  Agricultural  Trade  Update 

gives  you  up-to-the-minute  information. 

Each  month  the  U.S.  Agricultural  Trade  Update  brings  you  ERS’  most  up-to-the-minute  data 
on  the  farm  trade  sector.  This  useful  6-page  update  brings  you  the  most  current  figures, 
delivered  by  first-class  mail  to  ensure  timely  delivery. 

The  U.S.  Agricultural  Trade  Update  covers  the  monthly  farm  trade  balance,  U.S.  farm  imports 
and  exports  by  quantity  and  value,  and  leading  exports  and  exporters. 

A  1-year  subscription  to  the  U.S.  Agricultural  Trade  Update  costs  just  $15.  Or  save  by 
ordering  a  2-year  subscription  (that’s  24  issues)  for  $29,  or  a  3-year  subscription  for  $42. 
Please  add  10%  for  shipment  to  domestic  addresses;  35%  for  shipment  to  foreign  addresses 
(includes  Canada). 

Situation  and  Outlook  Agricultural  Trade  Reports 

give  you  the  facts  . .  .  and  the  forecasts! 

These  reports  provide  both  current  intelligence  and  historical  data  on  international  food  and 
agricultural  developments.  They  also  forecast  how  changes  in  conditions  and  policies  around 
the  world  will  affect  both  U.S.  and  international  agriculture. 

Outlook  for  U.S.  Agricultural  Exports  offers  the  latest  value  and  volume  of  U.S.  farm 
exports,  by  commodity  and  region,  as  well  as  the  agricultural  trade  balance,  import 
commodities,  and  export  outlook.  Subscription  includes  4  issues.  Agriculture  and  Trade 
reports  summarize  the  year’s  developments  affecting  U.S.  agriculture  and  trade  in  five  key 
regions,  and  look  to  the  future  with  articles  on  market  trends,  trade,  and  policy  (subscription 
includes  5  regional  reports:  USSR,  China,  Western  Europe,  Pacific  Rim,  and  Asia. 

The  cost  is  just  $12  for  a  1-year  subscription  per  title.  Or  save  by  ordering  a  2-year 
subscription  for  $23,  or  a  3-year  subscription  for  $33.  Please  add  10%  for  shipment  to 
domestic  addresses;  35%  for  postage  to  foreign  addresses  (includes  Canada). 

Foreign  Agricultural  Trade  of  the  United  States 

gives  you  the  latest  information  on  U.S.  markets. 

This  periodical  updates  the  quantity  and  value  of  U.S.  farm  exports  and  imports,  plus  price 
trends.  Its  coverage  of  over  200  countries  and  more  than  500  commodities  will  keep  you 
informed  of  how  U.S.  trade  stacks  up  in  a  global  market.  Subscription  includes  6  issues  plus 
calendar  and  fiscal  year  supplements. 

The  cost  is  just  $25  for  a  1-year  subscription.  Or  save  by  ordering  a  2-year  subscription  for 
$49,  or  a  3-year  subscription  for  $72.  Please  add  10%  for  shipment  to  domestic  addresses; 
35%  for  shipment  to  foreign  addresses  (includes  Canada). 

Order  now!  Rates  good  through  12/92. 

Call  our  order  desk  toll  free,  1-800-999-6779 

in  the  U.S.  and  Canada  (other  areas,  please  call  703-834-0125). 

Or  write:  ERS-NASS,  341  Victory  Drive,  Herndon,  VA  22070. 


Back  issues  of  ERS  periodicals 
in  prepackaged  sets 


Fill  in  your  collection  of  ERS  periodicals  with  packaged  sets  of  our  valuable  data  and 
analysis,  now  sale  priced.  While  supplies  last,  ERS  is  offering  sets  of  back  issues  of 
some  of  its  major  periodicals.  Round  out  your  personal  collection  of  Agricultural  Out¬ 
look,  for  example,  with  the  complete  set  of  issues  from  1990  or  1991.  Or  find  the  histori¬ 
cal  data  you  need  on  farm  income  and  expenses,  production  and  efficiency  statistics,  and 
more  with  past  years’  issues  of  Economic  Indicators  of  the  Farm  Sector. 

It’s  easy!  Just  write  ERS-NASS  at  341  Victory  Drive,  Herndon,  VA  22070, 

or  call  1-800-999-6779  (in  the  U.S.  and  Canada;  other  areas  call  703-834-0125)  today. 

And  attention  libraries:  We  offer  an  additional  $5  discount  per  peri¬ 
odical  package  to  your  institution.  Just  submit  your  order  on  letterhead,  or  on  a  purchase 
order  with  the  pre-printed  name  and  address  of  your  library.  Please  note  the  discounted 
price  in  your  order. 


Agricultural  Outlook  ’90.  11  issues; 
regular  price  if  sold  separately,  $88. 

Order  #  PKG-18.  $25. 

Agricultural  Outlook  ’91. 

1 1  issues;  regular  price  if  sold  separately,  $88. 

Order  #PKG-19.  $25. 

(Sorry,  1989  Agricultural  Outlook  not  available.) 

Foreign  Agricultural  Trade  of  the  United  States,  ’89. 

6  issues;  regular  price  if  sold  separately,  $48. 

Order  #PKG-20.  $20. 

Foreign  Agricultural  Trade  of  the  United  States,  ’90. 

6  issues;  regular  price  if  sold  separately,  $48. 

Order  #  PKG-21.  $20. 

Foreign  Agricultural  Trade  of  the  United  States,  ’91. 

6  issues;  regular  price  if  sold  separately,  $48. 

Order  #  PKG-22.  $20. 

Farmline  ’89. 

1 1  issues;  regular  price  if  sold  separately,  $88. 

Order  #  PKG-23.  $15. 

Farmline  ’90. 

1 1  issues;  regular  price  if  sold  separately,  $88. 

Order  #  PKG-24.  $15. 

Farmline  ’91. 

1 1  issues;  regular  price  if  sold  separately,  $88. 

Order  #  PKG-25.  $15. 


Economic  Indicators  of  the  Farm  Sector,  ’88. 

5  issues  covering  1988  statistics;  regular  price  if 
sold  separately,  $40. 

Order  #  PKG-26.  $18. 

Economic  Indicators  of  the  Farm  Sector,  ’89. 

5  issues  covering  1989  statistics;  regular  price  if 
sold  separately,  $40. 

Order  #PKG-27.  $18. 

Food  Review  ’89. 

4  issues;  regular  price  if  sold  separately,  $32. 

Order  #  PKG-28.  $16. 

Food  Review  ’90. 

4  issues;  regular  price  if  sold  separately,  $32. 

Order  #  PKG-29.  $16. 

Food  Review  ’91. 

4  issues;  regular  price  if  sold  separately,  $32. 

Order  #PKG-30.  $16. 

Journal  of  Agricultural  Economics  Research,  ’89. 
4  issues;  regular  price  if  sold  separately,  $32. 

Order  #PKG-31.  $15. 

Journal  of  Agricultural  Economics  Research,  ’90. 
4  issues;  regular  price  if  sold  separately,  $32. 

Order  #  PKG-32.  $15. 

Journal  of  Agricultural  Economics  Research,  ’91. 
4  issues;  regular  price  if  sold  separately,  $32. 

Order  #  PKG-33.  $15. 


Order  now!  Prices  good  through  December  1992. 

Add  10%  for  shipping  to  domestic  addresses;  35%  to  foreign  addresses. 


Stay  current  on... 

Agricultural  and  economics  statistics  and  analysis.  Commodity  analysis. 
Food  consumption.  Foreign  trade.  Biotechnology.  Rural  development. 
Banking.  Land  use. 

Reports  catalog  lists  monographs  and 
periodicals  available  from  USDA’s  econom¬ 
ics  agencies.  For  a  free  subscription  to  this 
quarterly  catalog,  write  to: 

ERS-NASS 

341  Victory  Drive 
Herndon,  VA  22070 

Or  call  toll  free  1-800-999-6779 

(in  the  U.S.  and  Canada;  other  areas 
please  call  703-834-0125). 
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U.S.  Department  of  Agriculture 
Economic  Research  Service 

1301  New  York  Avenue,  NW. 
Washington,  DC  20005-4788. 


